Ask fedora guidelines

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(List)
(List)
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
This page lists the good practices while using [http://ask.fedoraproject.org/ Ask Fedora]:
 
This page lists the good practices while using [http://ask.fedoraproject.org/ Ask Fedora]:
  
Please feel free to add more points to the list. If you need to discuss something with the forum moderators, [http://ask.fedoraproject.org/feedback/?next=/questions/ give feedback at Ask Fedora], or find us at [http://webchat.freenode.net/?randomnick=1&channels=ask-fedora-ops&uio=d4 #ask-fedora-ops on Freenode]!
+
Please feel free to add more points to the list. If you need to discuss something with the forum moderators, [http://ask.fedoraproject.org/feedback/?next=/questions/ give feedback at Ask Fedora], or find us at [http://webchat.freenode.net/?randomnick=1&channels=ask-fedora-ops&uio=d4 #ask-fedora-ops on Freenode]
 
+
== Purpose ==
+
Ask Fedora is set up to help users '''when they run into trouble while using their Fedora system'''. It is not meant to be a forum where we tutor users on Linux/Fedora/web development/blah blah. '''For these common questions, you need to Google, read your man pages and the plethora of blogs/howtos that the internet is full of.'''
+
  
 
== List ==
 
== List ==
 +
  
 
* '''Search before you post:''' Search the interweb and then Ask Fedora itself before posting your question.
 
* '''Search before you post:''' Search the interweb and then Ask Fedora itself before posting your question.
Line 12: Line 10:
 
* '''Frame a question:''' It's '''Ask''' Fedora after all.
 
* '''Frame a question:''' It's '''Ask''' Fedora after all.
 
* '''It is perfectly OK to answer a question that you asked:''' There's nothing stopping you from answering your own questions. When you do, '''please post your answer separately, and not in the question description'''.  
 
* '''It is perfectly OK to answer a question that you asked:''' There's nothing stopping you from answering your own questions. When you do, '''please post your answer separately, and not in the question description'''.  
* '''Write English:''' At the moment, we do not have support for different languages in Ask Fedora. It's a feature that will be added in the future. Please write complete words and not SMS lingo here ("please", not "PLS"). This is not messaging, there is no shortage of space. Please use single, correct punctuations. "!!!" doesn't mean anything.
+
* '''Write English:''' At the moment, we do not have support for different languages in Ask Fedora. It's a feature that will be added in the future. Please write complete words and not SMS lingo here ("please", not "PLS"). This is not messaging, there is no shortage of space. Please use single, correct punctuation's. "!!!" doesn't mean anything.
* '''Ask good questions:''' [http://ask.fedoraproject.org/question/534/sticky-can-we-have-some-guidelines-for-framing?answer=1041#answer-container-1041 Here’s a great post] that tells you how to ask good questions
+
* ''' File bugs in bugzilla:'''  If it is a package related issue or you are requesting an update for some package, do so directly via bugzilla.  If you haven't done that before, refer to [[How_to_file_a_bug_report]]
 +
* '''Ask questions in a useful manner''' [http://ask.fedoraproject.org/question/534/sticky-can-we-have-some-guidelines-for-framing?answer=1041#answer-container-1041 Here’s a great post] that tells you how to ask good questions. [http://catb.org/~esr/faqs/smart-questions.html Here are some more tips on getting answers].
 
* '''Provide information about to help people help you better:''' People can't help you if you do not provide specific information on the issue you face. Some commands and logs that you should look for information to provide with your questions:
 
* '''Provide information about to help people help you better:''' People can't help you if you do not provide specific information on the issue you face. Some commands and logs that you should look for information to provide with your questions:
 
** '''lsusb''': Information on USB devices
 
** '''lsusb''': Information on USB devices
Line 24: Line 23:
 
** '''/var/log/pm-suspend.log''': Suspend/resume logs
 
** '''/var/log/pm-suspend.log''': Suspend/resume logs
 
** '''Google''': All of the above logs and commands can be learned from the internet.  
 
** '''Google''': All of the above logs and commands can be learned from the internet.  
* '''Use the tools:''' When you want to post information along with your question, please use the tools, such as quoting, code snippet etc. If folks can’t read your questions, they cannot answer them.
+
* '''Use the tools:''' When you want to post information along with your question, please use the tools, such as quoting, code snippet etc. If folks can’t read your questions quickly, they are not likely to answer them.
 
* '''Use correct tags:''' Make use of existing tags instead of adding new ones. This increases the visibility of your question. Remember that tags are without spaces, so “fedora16″ is not the same as “fedora 16″. The latter actually breaks up into two separate tabs “fedora” and “16″ which is illogical.
 
* '''Use correct tags:''' Make use of existing tags instead of adding new ones. This increases the visibility of your question. Remember that tags are without spaces, so “fedora16″ is not the same as “fedora 16″. The latter actually breaks up into two separate tabs “fedora” and “16″ which is illogical.
 
* '''Is that an answer?:''' Only post answers when you're providing a solution to the asked question. For everything else, comment on the appropriate question/answer. Having a thread of conversation as answers just confuses people looking for information. Use comments. Only post an answer when you have one.
 
* '''Is that an answer?:''' Only post answers when you're providing a solution to the asked question. For everything else, comment on the appropriate question/answer. Having a thread of conversation as answers just confuses people looking for information. Use comments. Only post an answer when you have one.
* '''Go through the [http://ask.fedoraproject.org/questions/?search=&query=sticky sticky posts]!'''
+
* '''Go through the [http://tinyurl.com/askfedora-sticky "sticky" posts]!'''
 
* '''Subscribe to questions you ask/answer/comment:''' A lot of answered questions are not marked so because the original asker hasn’t cared to follow up!
 
* '''Subscribe to questions you ask/answer/comment:''' A lot of answered questions are not marked so because the original asker hasn’t cared to follow up!
 
* '''Reward your helpers:''' This is most important. Mark answers as correct, vote up a good question, vote down a bad one, comment for queries. This will make it a better, more knowledgeable forum. '''Use your votes!'''.  Do not rename the question to add a "Solved" tag.  Just pick the answer you like as the correct one instead.  
 
* '''Reward your helpers:''' This is most important. Mark answers as correct, vote up a good question, vote down a bad one, comment for queries. This will make it a better, more knowledgeable forum. '''Use your votes!'''.  Do not rename the question to add a "Solved" tag.  Just pick the answer you like as the correct one instead.  
 
* '''If you see someone not using the forum correctly, point it out:''' Comment telling them what they're doing wrong '''politely'''. Hint: Use ''"Please mark an answer as correct."'' instead of ''"Mark an answer as correct."''
 
* '''If you see someone not using the forum correctly, point it out:''' Comment telling them what they're doing wrong '''politely'''. Hint: Use ''"Please mark an answer as correct."'' instead of ''"Mark an answer as correct."''
* '''Do not take offence at being down voted:''' Down voting implies that someone doesn't think your answer is good enough, or complete. This isn't personal at all. What this actually means is that you have the opportunity to learn something new. Please do not take offence if your answer is down voted. It's how the forum is designed to work.  
+
* '''Do not take offense at being down voted:''' Down voting implies that someone doesn't think your answer is good enough, or complete. This isn't personal at all. What this actually means is that you have the opportunity to learn something new. Please do not take offence if your answer is down voted. It's how the forum is designed to work.  
 
* Last but not least '''be polite and refrain from ranting:''' Ranting makes people not want to help you. There isn't anything else to it. If you're polite, folks will want to help you.
 
* Last but not least '''be polite and refrain from ranting:''' Ranting makes people not want to help you. There isn't anything else to it. If you're polite, folks will want to help you.
 +
 +
== Short cuts ==
 +
* build#xxxxx links to http://koji.fedoraproject.org/koji/buildinfo?buildID=xxxx
 +
* bug#xxxxx links to https://bugzilla.redhat.com/show_bug.cgi?id=xxxxxx
 +
* rhbz#xxxxx links to https://bugzilla.redhat.com/show_bug.cgi?id=xxxxxx
 +
* wiki:someURL links to https://fedoraproject.org/wiki/someURL
 +
* packagedb:packageName links to http://bugz.fedoraproject.org/packageName
 +
* question#XXXX links to another question on the forum (active on the staging instance only at the moment)
  
 
== Page owner ==
 
== Page owner ==
  
 
[[User:Ankursinha| Ankur Sinha 'FranciscoD']]
 
[[User:Ankursinha| Ankur Sinha 'FranciscoD']]

Revision as of 03:50, 8 August 2013

This page lists the good practices while using Ask Fedora:

Please feel free to add more points to the list. If you need to discuss something with the forum moderators, give feedback at Ask Fedora, or find us at #ask-fedora-ops on Freenode

List

  • Search before you post: Search the interweb and then Ask Fedora itself before posting your question.
  • If you have more than one question, post them separately: Do not write a post that says “many Fedora questions” and ask them all together. You’re to ask each question separately.
  • Frame a question: It's Ask Fedora after all.
  • It is perfectly OK to answer a question that you asked: There's nothing stopping you from answering your own questions. When you do, please post your answer separately, and not in the question description.
  • Write English: At the moment, we do not have support for different languages in Ask Fedora. It's a feature that will be added in the future. Please write complete words and not SMS lingo here ("please", not "PLS"). This is not messaging, there is no shortage of space. Please use single, correct punctuation's. "!!!" doesn't mean anything.
  • File bugs in bugzilla: If it is a package related issue or you are requesting an update for some package, do so directly via bugzilla. If you haven't done that before, refer to How_to_file_a_bug_report
  • Ask questions in a useful manner Here’s a great post that tells you how to ask good questions. Here are some more tips on getting answers.
  • Provide information about to help people help you better: People can't help you if you do not provide specific information on the issue you face. Some commands and logs that you should look for information to provide with your questions:
    • lsusb: Information on USB devices
    • lspci: Information on PCI devices
    • dmesg: Kernel messages
    • uname -a: Current running kernel
    • /var/log/Xorg.0.log: X server errors, for example when you don't get a display on boot
    • /var/log/messages: Kernel and more common errors
    • ~/.xsession-errors: User session errors
    • /var/log/pm-suspend.log: Suspend/resume logs
    • Google: All of the above logs and commands can be learned from the internet.
  • Use the tools: When you want to post information along with your question, please use the tools, such as quoting, code snippet etc. If folks can’t read your questions quickly, they are not likely to answer them.
  • Use correct tags: Make use of existing tags instead of adding new ones. This increases the visibility of your question. Remember that tags are without spaces, so “fedora16″ is not the same as “fedora 16″. The latter actually breaks up into two separate tabs “fedora” and “16″ which is illogical.
  • Is that an answer?: Only post answers when you're providing a solution to the asked question. For everything else, comment on the appropriate question/answer. Having a thread of conversation as answers just confuses people looking for information. Use comments. Only post an answer when you have one.
  • Go through the "sticky" posts!
  • Subscribe to questions you ask/answer/comment: A lot of answered questions are not marked so because the original asker hasn’t cared to follow up!
  • Reward your helpers: This is most important. Mark answers as correct, vote up a good question, vote down a bad one, comment for queries. This will make it a better, more knowledgeable forum. Use your votes!. Do not rename the question to add a "Solved" tag. Just pick the answer you like as the correct one instead.
  • If you see someone not using the forum correctly, point it out: Comment telling them what they're doing wrong politely. Hint: Use "Please mark an answer as correct." instead of "Mark an answer as correct."
  • Do not take offense at being down voted: Down voting implies that someone doesn't think your answer is good enough, or complete. This isn't personal at all. What this actually means is that you have the opportunity to learn something new. Please do not take offence if your answer is down voted. It's how the forum is designed to work.
  • Last but not least be polite and refrain from ranting: Ranting makes people not want to help you. There isn't anything else to it. If you're polite, folks will want to help you.

Short cuts

Page owner

Ankur Sinha 'FranciscoD'