CocoaDev

Edit AllPages

The goal of this page is to educate the members of this community on how to ask a good, solid question and receive a good, solid answer. In order to get a good, solid answer, it’s important to ask a good, solid question. Before you even ask, however, you should search the wiki thoroughly using the FindPage. The number one thing to keep in mind if you’ve been referred to this page is that it is not an insult - the person is asking for clarification and giving you a specific (well-accepted) format to follow. Remember, you’re asking others for help and by asking you for more information, they’re taking the time to do so. Don’t take it personally!


The Reasonable Question

Asking the ‘perfect’ question is probably a lofty goal. Best to settle for a ‘reasonable question’.

First and foremost, post your goal. What do you intend to accomplish? “I want it to work.” is insufficient. Please elaborate! *Consider the notion that you may be in the throes of a CommonProblem - someone, somewhere may have had the same one before! *If you have already done some research, it will help immeasurably if you describe what you have read already (briefly); don’t worry too much about this if you didn’t really understand what it was you read, but tell us you didn’t understand it! *Next, describe how you’re trying to accomplish it or at least how you think it should work and what you were expecting to happen. *Also, make sure you state what actually happened - what went ‘wrong’. *If you are having a problem with your own code, post the code in question. Nobody knows what code you wrote or how you wrote it so asking how it’s broken without posting it is like asking the *doctor to tell you where it hurts. :-) In other words, post your problem code! *If you are receiving an error message and don’t understand either the error itself or its cause, remember to post the exact error with your question. If you don’t say what the error is, the best anyone can give you is a guess. *Don’t post a question in an unrelated page. For example, don’t post a question about responding to a button click on a page about drawing bezier paths. *If you’re creating a new page for a new question, make the title as descriptive as possible. Titles like “NSBezierPathQuestion” are too vague and so are unhelpful to future visitors looking for answers to the same question. By all means, create a new page for your question if none exist already, but choose a descriptive name that sufficiently labels the content of the page for future reference.

Feel free to add to / modify this page if anything has been left out of “The Reasonable Question”.


Related Pages

[Topic]

Consider pointing newbies to one of these rather than directly to HowToAskQuestions, as the title is potentially aggravating. If they follow the link, they should find their way here.


Outside Resources

Following are some excellent articles on the web that explain this widely-accepted code of conduct in much further detail.

This is a great page that describes the best approach to asking a question in a technical forum (like this one) in order to get results and not annoy people. Written by Eric Steven Raymond. “In the world of hackers, the kind of answers you get to your technical questions depends as much on the way you ask the questions as on the difficulty of developing the answer. This guide will teach you how to ask questions in a way that is likely to get you a satisfactory answer.”

http://www.catb.org/~esr/faqs/smart-questions.html

A shorter guide by MikeAsh of this parish:

http://www.mikeash.com/getting_answers.html

Here is another one, on why questions go unanswered. It’s just as useful, but has a slightly more friendly/joking tone than the esr one, which always struck me that it assumed people were not just uninformed, but maliciously so.

http://perl.plover.com/Questions.html [ Server seems to be down as of July 11, 2006 ]

Are you or do you know a Help Vampire? Taken from mmalc’s list FAQ post on the cocoa-dev mailing list ( http://www.lists.apple.com/ ).

http://www.slash7.com/pages/vampires


Discussion

How to ask questions is a touchy subject and one prone to lengthy debate. Debate is a good thing. If you have an opinion, weigh in! Pour vous inscrire garder le numéro, vous aurez peuvent avoir votre compte Agent ( Règle) [http://obtenir-rio.info numero rio]. Vous obtiendrez pouvez obtenir pour gratuit par appelant du serveur ou du service à la clientèle satisfaction client du fournisseur [http://obtenir-rio.info/rio-bouygues numero rio bouygues] . Vous ne recevez immédiatement un SMS avec votre . Avec du [http://obtenir-rio.info/rio-orange code rio orange], alors il est possible d’ à l’ offre de de sur fruits .