821

My earlier blog post on how to write a good question is pretty long, and I suspect that even when I refer people to it, often they don't bother reading it. So here's a short list of questions to check after you've written a question (and to think about before you write the question):

  1. Have you done some research before asking the question? 1
  2. Have you explained what you've already tried to solve your problem?
  3. Have you specified which language and platform you're using, including version number where relevant?
  4. If your question includes code, have you written it as a short but complete program? 2
  5. If your question includes code, have you checked that it's correctly formatted? 3
  6. If your code doesn't compile, have you included the exact compiler error?
  7. If your question doesn't include code, are you sure it shouldn't?
  8. If your program throws an exception, have you included the exception, with both the message and the stack trace?
  9. If your program produces different results to what you expected, have you stated what you expected, why you expected it, and the actual results?
  10. If your question is related to anything locale-specific (languages, time zones) have you stated the relevant information about your system (e.g. your current time zone)?
  11. Have you checked that your question looks reasonable in terms of formatting?
  12. Have you checked the spelling and grammar to the best of your ability? 4
  13. Have you read the whole question to yourself carefully, to make sure it makes sense and contains enough information for someone coming to it without any of the context that you already know?

If the answer to any of these questions is "no" you should take the time to fix up your question before posting, by going through this list. I realize this may seem like a lot of effort, but it will help you to get a useful answer as quickly as possible; and you might even solve your problem yourself in the process! 5

Don't forget that you're basically asking other people to help you out of the goodness of their heart - it's up to you to do all you can to make that as simple as possible.


1 If you went from "something's not working" to "asking a question" in less than 10 minutes, you probably haven't done enough research. This should include things like normal web searches (e.g. for an error message you're receiving), checking the documentation, debugging (particularly for exceptions) and searching on Stack Overflow itself for similar questions.

2 Ideally anyone answering the question should be able to copy your code, paste it into a text editor, compile it, run it, and observe the problem. Console applications are good for this - unless your question is directly about a user interface aspect, prefer to write a short console app. Remove anything not directly related to your question, but keep it complete enough to run.

3 Try to avoid code which makes users scroll horizontally. You may well need to change how you split lines from how you have it in your IDE. Take the time to make it as clear as possible for those trying to help you.

4 I realize that English isn't the first language for many Stack Overflow users. We're not looking for perfection - just some effort. If you know your English isn't good, see if a colleague or friend can help you with your question before you post it.

5 This is a bit like rubber duck debugging

35
  • 4
    a gentle version of WSOiN? (10k only) :)
    – gnat
    Commented Nov 27, 2012 at 9:14
  • 11
    @gnat: Yes - more focused on getting the right information in the question.
    – Jon Skeet
    Commented Nov 27, 2012 at 9:33
  • 18
    I love this. I do. But I think it's still far too long for the entry level folks. Commented Nov 27, 2012 at 19:53
  • 38
    I realize this may seem like a lot of effort, but it will help you to get a useful answer as quickly as possible More to the point, it's only right for the person looking for help to put in that effort, rather than expecting us to do it for them! I guess much of the time they don't even realise or understand that that is what we're doing. Commented Nov 27, 2012 at 19:55
  • 8
    @LightnessRacesinOrbit: Too long, or too demanding? That's the thing - this is all for the ultimate of the person asking the question. I've been accused of being "elitist" as if any of these items is only feasible for expert programmers. I don't know how we get over that hurdle.
    – Jon Skeet
    Commented Nov 27, 2012 at 19:58
  • 5
    @JonSkeet The first line, Have you done some research before asking the question IMPO need some extra tips to the new users, some steps that need to be made as: 1. Google the error code, 2. Look inside the SO for similar keywords with the error or the issue, look on other standard sites for sample code, or other samples 3. After have find all possible or similar solutions, then to try to solve it alone, then come and make a question and show what have try on that part. I say that because they do not even search on SO for similar questions on many cases.
    – Aristos
    Commented Nov 27, 2012 at 22:41
  • 2
    @Aristos: I don't understand your proposal, I'm afraid. Perhaps something on the "exception" point?
    – Jon Skeet
    Commented Nov 28, 2012 at 9:18
  • 6
    I'm afraid that both the length of the list and the length of each item (not to speak of the footnotes) will still turn away those who would most need it. It should be even more distilled to a smaller number of short items. Commented Nov 28, 2012 at 9:44
  • 3
    Those who don't try to do research or put efforts will neither read this Checklist nor read FAQ.
    – Hardik Mishra
    Commented Nov 28, 2012 at 9:55
  • 13
    @Hardik that's not the point. It's a helpful resource that we can point people to when their question gets closed.
    – Pekka
    Commented Nov 28, 2012 at 10:02
  • 2
    @Tshepang: I don't see how "If this gets deleted, so be it" is "inflammatory" - I was simply acknowledging that some people might feel it's too close to the "What Stack Overflow is not" post, and vote to delete it. If that happened, I wasn't going to kick up a fuss. The intention was to be the opposite of inflammatory... still, it seems like it isn't needed, so I'm happy not to roll back the edit.
    – Jon Skeet
    Commented Nov 29, 2012 at 19:25
  • 2
    I find myself editing tags a lot, perhaps you can include "did you apply the most relevant tags on your question?"
    – Amro
    Commented Jun 27, 2013 at 8:15
  • 3
    Some, if not most of this information should be added to the How to Ask page in one form or another. I find myself having a hard time to decide where to point users. The How to Ask page is lacking in information while this post is a bit too verbose.
    – mekwall
    Commented Jul 7, 2013 at 14:09
  • 3
    @Oakcool: I don't know what appropriate alternative there is, but a lack of alternatives doesn't make an opinion-based question welcome on SO.
    – Jon Skeet
    Commented Aug 1, 2013 at 5:57
  • 3
    @Raedwald: Well, it at least allows me to direct someone who's already posted something somewhat rubbish to a fairly concise list - it gives them an easy second chance.
    – Jon Skeet
    Commented Aug 4, 2014 at 17:57

4 Answers 4

211

I think to actually get the average asker of bad questions to read those items, they need to be fewer and shorter. This means sacrificing precision.

Something like this, maybe:

  • Did you google your question (going beyond the first page)?
  • What have you tried?
  • What language/IDE are you using?
  • Did you even supply code for your question?
  • Does your sample code compile/run?
  • Is your sample code formatted to be readable?
  • Did you include the full error message, if you get any?
  • Is your spellchecker turned on?

Yes, this does not include a lot of useful/good information of the original list, but all that information is no use if it's not read, and I'd rather have them read the limited version than not read anything at all.

9
  • 28
    Getting that balance is definitely the problem. Maybe a "short form" and then a "long form" would be useful. (That's why I've given footnotes rather than including long items.)
    – Jon Skeet
    Commented Nov 28, 2012 at 9:55
  • 3
    Maybe when "bad question" with many negate votes, get a messages with a link to that page, the asker take some time to read all.
    – Aristos
    Commented Nov 28, 2012 at 10:01
  • 2
    @Aristos: maybe I'm too cynical, but I'm afraid that no: the majority will simply never read that much test, they "just want their problem solved now!". Commented Nov 28, 2012 at 10:06
  • 8
    @Joachim sure, but those are easy to downvote and closevote. This list will help those OP's who really want to know, and saves existing users the effort of explaining the same things over and over and over
    – Pekka
    Commented Nov 28, 2012 at 20:27
  • 5
    @Aristos It does that now. Commented Jul 8, 2013 at 15:02
  • 1
    "Did you pay attention to the suggestions offered when you wrote the title?"
    – mplungjan
    Commented Nov 16, 2013 at 7:22
  • I would also add: "Do you have an actual problem to solve? This is not the place to discuss, rant or dump your frustration." I was guilty of this so many times.
    – Calmarius
    Commented Dec 19, 2013 at 18:32
  • One might get better results with "average askers of bad questions" by giving them a playlist of short succinct video-clips demonstrating A) WHAT to do, B) WHAT NOT to do C) HOW to do it D) WHAT it'll look when it's done AND most importantly E) How it'll help THEM get an answer to their question FASTER.
    – GuruM
    Commented Aug 27, 2014 at 9:32
  • 4
    "You can lead a horse to water, but you can't make him drink." Not even if you condense several gallons of water into a single drop and attempt to shove it up his nose with accompanying flashing red lights. Some people just won't read the instructions. The answer is not to further abbreviate the instructions. Write the instructions so they are inviting, concise, and complete (which @JonSkeet has already accomplished), and then ignore the few who still can't be bothered to read them.
    – Wildcard
    Commented Mar 31, 2016 at 22:44
33

Both question and answer are quite old, yet in my opinion still accurate. I would recommend to do a combination of both ideas. I suggest to start with a real short overview as posted by Joachim Sauer. But I would change the order of it to a more logical one (in my opinion):

  • Did you explain your EXACT problem?
  • Did you include the full error message, if you get any?
  • What have you tried?
  • Did you search for similar questions?
  • What language/IDE are you using?
  • Does your sample code compile/run?
  • Is your sample code formatted to be readable?
  • Is your spellchecker turned on?

and then I would turn each of those points into a hyperlink which can be clicked to get a more detailed comment, what is recommended, why and who to process this point.

That way you have something like a check list which I would display like the "How to ask" orange box visible whenever you ask a new question and which links to a FaQ/help section if you need further details on one or more points mentioned above.

17

"If a picture is worth a thousand words, a video must be worth millions (of words)". A long and dense FAQ/checklist seems like a logical candidate for a video especially for newbies.

Current Situation:

Significantly, it took at least 30-40 minutes to find an OK Stack Overflow how-to video. It seems like Stack Overflow is a text-only site (for ex-Usenet users maybe?). Joel Spolsky claims in his talks that Stack Overflow is a break from Usenet email-style conversations. Maybe it's time to add some video help especially for newbies.

Entry-Barrier:


  • It's an oft-repeated complaint newbies don't RTFM, FAQ, Checklists, etc.
  • From the newbie perspective the primary urge is to 'Answer my question/solve my problem/do my homework already!!'.
  • To get better quality questions and answers we need to help newbies re-focus on Stack Overflow readership rather than the question. The video would help the newbie get over the entry barrier (kind of like a human-operator option of an IVR system).

Reducing Entry Barrier:

  • Cognitive Style: The communication medium has to suit the newbies' learning style - Video, Audio, Kineaesthetic (jsFiddle).
  • Reduce time for a newbie to get at least 60-80% of the process right the first time? Show him/her how to do it with an example video.
  • Reduce effort by meeting them half-way by doing the reading/demonstration.
  • Non-native users are not too comfortable with reading English. Adding subtitled small video-clips can go really far in reducing the entry barrier.

Solution:

A playlist of multiple 5-10 minute clips is more useful than a single big video.

A playlist of short succinct video-clips demonstrating:

  • WHAT to do
  • WHAT NOT to do
  • HOW to do it
  • WHAT it'll look like when it's done and most importantly
  • How it'll help newbies get an answer to their question FASTER

Advantages:

  • If a newbie learns the top 80% of proper usage from the videos, the site should see a lot of happy users - newbies as well as moderators. The rest can come from links to FAQ, experience, etc.
  • Helps moderators give short clips to reduce/avoid specific misbehavior.
  • Helps "goal-oriented"/"attention-deficit"/"reading-disabled"/clueless newbies latch on fast.
  • Helps reduce learning curve and bridge the learning-gap with least effort.

YouTube is full of newbie learning videos (from Arduino to graphene to cooking). Searching video-first and text-next saves time/effort and gives a starting point if it's worth following up.

Resources:

These are currently available videos which can act as starting points. They are too lengthy to be useful as they are. However, making 5-10 minute clips would make a huge difference in accessibility.

NOTE:

  • The video-clips can be incrementally user contributed and remixed via Mozilla Popcorn.
  • TED.com and Mozilla use Amara.org team/individual subtitle editor to crowd-source subtitles and internationalize their videos.
12
  • 16
    Those videos are both longer than 50 minutes. Compare that with the "looong" checklist in this question - how long do you really think that takes to read? 2 minutes? 5? Surely not more than 10. I'm not saying that videos are a bad idea, but you don't seem to be consistent in the length of time you consider people are willing to put in.
    – Jon Skeet
    Commented Aug 27, 2014 at 7:11
  • 2
    You're absolutely right! Actually I suggest a Playlist of 5-10 minute videos instead of these long videos. Actually I'm working on a project to make large videos more accessible using social-media and clips, so I have spent quite some time thinking on this issue. The same problem is shared by any online community.
    – GuruM
    Commented Aug 27, 2014 at 7:13
  • 2
    Also the videos themselves need not be static but can be incrementally created and remixed by users with Popcorn online video. This requires no additional infrastructure other than storing the video on youtube/vimeo etc.
    – GuruM
    Commented Aug 27, 2014 at 7:17
  • 3
    It's not just about reading-time, but reading-ease. I've seen lots of people who avoid reading and would rather spend time dabbling or asking others verbally/visually through a diagram. Text-based online forums totally tilt the balance in favour of reading/writing people vs. auditory/visual cognitive style.
    – GuruM
    Commented Aug 27, 2014 at 7:37
  • 2
    @JonSkeet Ironically I came to this question and your posts on SO after hearing about you in the "Good StackOverflow Citizen" Video by Jeff Attwood! :-)
    – GuruM
    Commented Aug 27, 2014 at 7:44
  • 3
    I don't think one can expect people who have trouble understanding the checklist to understand a 10 minute video. The way I perceive it, those asking low quality first questions want answers right now! - why bother watching a video? Why pay attention there? Why assume, that if you have trouble understanding the English in the checklist you can follow the spoken English of a video? The website I can try to translate with a dictionary.
    – Schorsch
    Commented Aug 27, 2014 at 12:27
  • 2
    @Schorsch Why assume that the newbie knows what he/she's doing wrong? Why assume they're not intelligent because they don't read a long rule-list? Why not give him/her a chance to edit their questions based on a 10 minute video howto. Adding the video brings back the human-touch and helps make re-framing the question into a learning experience. Adding simple subtitles for 10 minute video isn't be too hard by correcting auto-subtitles from youtube.
    – GuruM
    Commented Aug 27, 2014 at 12:53
  • 2
    What I understand from Joel video talks is that SO wants techie layer to use questions as a sand-grain for pearl-making. This results in brusqueness towards newbies (intentional or otherwise). Instead it might be better to help newbies make better sand-grains then.
    – GuruM
    Commented Aug 27, 2014 at 12:55
  • 2
    Understanding a checklist is not the same as recalling the checklist. Seems like an old problem with 'Thou Shalt Not'!! I deleted the answer after downvotes. Undeleting it to give a different perspective on the issue.
    – GuruM
    Commented Sep 27, 2014 at 20:09
  • It might be the case that learning styles are a myth.
    – Galen
    Commented Jul 16, 2021 at 20:21
  • 1
    Our own Kate Gregory (own, but separate YouTube channel) has a Pluralsight course, "StackOverflow and StackExchange Site", in many parts, 5-10 minutes each. It was once on YouTube (e.g. StackOverflow and StackExchange Site Lesson 23), but the entire "Pluralsight" YouTube channel was deleted. Commented Oct 7, 2022 at 12:23
  • Native or not, yes, there is something to be said for audio and video in contrast to text: "People rarely read 90-minutes blog posts." Commented Oct 7, 2022 at 17:29
0

I have here an invisible checklist that an asker can easily paste into their question and use as a checklist checking of items as they go. Just make sure to copy it all1 and check to make sure it doesn't show up in the actual question.

<!--
[☐☑☒]
───────────────────────
 ☐ research before asking.
  ☐ web searches
  ☐ documentation
  ☐ stack overflow
───────────────────────
☐ what already tried
───────────────────────
☐ language
☐ platform version number
───────────────────────
☐ short code
☐ complete program 
───────────────────────
☐ correctly formatted code 
───────────────────────
☐ compiler error(if one)
───────────────────────
☐ Should Question has no code?(if doesn't contain code)
───────────────────────
☐ included the exception(if one)
  ☐ message
  ☐ stack trace
───────────────────────
☐ expected
☐ why expected it
☐ actual results
───────────────────────
☐ relevant information about system
───────────────────────
☐ question looks reasonable in formatting
───────────────────────
☐ spelling
☐ grammar
───────────────────────
☐ read to yourself
☐ enough information 
───────────────────────
-->

1the <!-- and --> are vital in order for the checklist to NOT show up. You DO NOT want the checklist to show up as it(most likely) has NO relevance to the question you may want to ask.
Note: This checklist is based off of the above checklist.

5
  • 7
    This checklist is optimized for "sand", for debugging questions (version number, compiler error, exception, stack trace, expected vs actual, system information). It doesn't really matter if any of this is included. Just let people debug their own code.
    – user6655984
    Commented Jul 30, 2017 at 20:12
  • 1
    @Alex This checklist is simply based off of the given checklist above and such things as (exception, compiler error, etc.). If the checklist does not adequately convey the checklist above then feel free to mention how it can be improved(without getting overly long).
    – merlin
    Commented Jul 31, 2017 at 19:02
  • 2
    I honestly don't think this serves any purpose other than to clutter up the question text, even "hidden." There's just a ton of text with nothing to gain from it.
    – Ajean
    Commented Jul 31, 2017 at 19:14
  • 4
    @Ajean I see how it would end up cluttering questions up however I thought it might be nice to have an actual checklist available, at least for people who are new to Stack Overflow.
    – merlin
    Commented Jul 31, 2017 at 19:24
  • 1
    Stack Overflow, not stack overflow. Commented Mar 4, 2022 at 4:38

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .