55

Today, the close reason reads similar to this:

Questions seeking debugging help ("why isn't this code working?") must include the desired behavior, a specific problem or error and the shortest code necessary to reproduce it in the question itself. Questions without a clear problem statement are not useful to other readers. See: How to create a Minimal, Complete, and Verifiable example.

This isn't exactly clear because people often believe that including a picture in the question satisfies the "shortest code necessary" requirement.

Can we simply add these words? (Emphasis mine)

Questions seeking debugging help ("why isn't this code working?") must include the desired behavior, a specific problem or error and the shortest code necessary (not a picture or video of your code) to reproduce it in the question itself. Questions without a clear problem statement are not useful to other readers. See: How to create a Minimal, Complete, and Verifiable example.

36
  • 6
    How do I flex my diamond?
    – BoltClock
    Nov 13, 2018 at 16:58
  • 16
    This might cause users to ask how to post videos of their code ;) How about "... shortest code in text format necessary to reproduce..."?
    – honk
    Nov 13, 2018 at 16:59
  • 1
    @honk: I will add that in while I roll my eyes...Geez. Who would dare post a video of their code and have the question survive for more than an hour?
    – Makoto
    Nov 13, 2018 at 17:00
  • 4
    @BoltClock: I'm confused and afraid. What are you on about? :)
    – Makoto
    Nov 13, 2018 at 17:00
  • 8
    @Makoto: Apparently mods can edit close reasons according to their whims. (I wasn't about to hammer your question, in case it came off that way...)
    – BoltClock
    Nov 13, 2018 at 17:01
  • 11
    @Makoto: Yeah, I made that comment because I realized I have no idea how to even use the thing.
    – BoltClock
    Nov 13, 2018 at 17:03
  • 2
    @Makoto I don't know, closing a question within an hour just because they posted a video of their question doesn't sound very welcoming to new users. ;)
    – krillgar
    Nov 14, 2018 at 11:08
  • 1
    @BoltClock you don't want to flex it - diamond is notoriously brittle ;)
    – user5940189
    Nov 14, 2018 at 17:23
  • 1
    @Orangesandlemons: I thought so!
    – BoltClock
    Nov 14, 2018 at 17:24
  • 1
    @honk - Added an answer doing that. Nov 16, 2018 at 9:02
  • 1
    @coder-croc - Added an answer doing that. (Really wish multiple @ notifications were a thing.) Nov 16, 2018 at 9:02
  • 1
    Occasionally I come across questions that post screenshots of code, but from what I can see it's not a widespread issue. In my experience it goes one of two ways: a) the querent is asked to post code as text in a comment and amends their question either before it's closed, or b) the querent is asked to post code as text in a comment and never amends their question, even after it's closed. Hence I'm not sure adding this extra information to a close reason would be that helpful. Adding it to the new question wizard on the other hand might indeed be worthwhile (in case it's not there already). Nov 16, 2018 at 9:10
  • 1
    Is there data on how frequently on hold/closed questions with pictures are currently salvaged by removing the pictures?
    – user2201041
    Nov 16, 2018 at 12:44
  • 1
    @JETM - I'd love to see that. Anecdotally, for me in the tags I frequent (javascript, html, css, java) it's very hit-or-miss, and you can usually tell from the quality of the rest of the question whether it'll happen. (Generally well-written otherwise? Yes. Generally poor, vague, and clearly not even read-through before posting? No.) Nov 16, 2018 at 14:32
  • 1
    @Makoto: I'm only getting around to it now because reasons, but now I've hit another roadblock: the current close reason is already at the very edge of a bloody character limit. Any attempt to incorporate this into the existing reason will have to sacrifice an entire other sentence. Currently considering axing the "clear problem statement" bit since, while important, it appears quite tangential to the essence of the reason.
    – BoltClock
    Dec 10, 2018 at 11:35

1 Answer 1

13

Very much like this addition. I would tweak it slightly:

Questions seeking debugging help ("why isn't this code working?") must include the desired behavior, a specific problem or error and the shortest code necessary to reproduce it in the question itself (as text, not as a picture, video, or off-site link). Questions without a clear problem statement are not useful to other readers. See: How to create a Minimal, Complete, and Verifiable example.

or

Questions seeking debugging help ("why isn't this code working?") must include the desired behavior, a specific problem or error and the shortest code necessary to reproduce it in the question itself. Include code as text, not as a picture, video, or off-site link. Questions without a clear problem statement are not useful to other readers. See: How to create a Minimal, Complete, and Verifiable example.

("picture" could be "screenshot")

13
  • 3
    Isn't saying "Don't add a picture of your code" like "Do not think about a pink elephant"? As in: isn't it better to not mention pictures/videos at all, but simply stick with what they should do: post it in text? Reconsideration: when the 'evil' has already been done (there's a picture/video) it's presumably fine, but if there's no code (text, or otherwise) won't they then add it as a picture anyway, since you mentioned the word 'picture'?
    – Adriaan
    Nov 16, 2018 at 9:19
  • 1
    @Adriaan don't jump out the window. Damn, will I be convicted for murdering you know? Why would people suddenly start doing things if you tell them not to? Reasonable people looking for help with their questions, anyways.
    – DonQuiKong
    Nov 16, 2018 at 9:25
  • 1
    @DonQuiKong "reasonable people" <- there's your problem. If they'd be reasonable, they'd have taken the tour and read How to Ask, including [mcve] and the question wouldn't be put on hold in the first place.
    – Adriaan
    Nov 16, 2018 at 9:27
  • @Adriaan - If it weren't for the fact that people do it routinely without the prompt, I'd agree. Sadly, though, they do, so addressing it is (to my mind) appropriate. Nov 16, 2018 at 9:29
  • 1
    @Adriaan oh but not infroming yourself and deliberately doing what you're told not to do are two pairs of shoes.
    – DonQuiKong
    Nov 16, 2018 at 9:33
  • 6
    I like the second version more. The less braces and brackets in text which is not code, the better IMO.
    – Gimby
    Nov 16, 2018 at 11:46
  • 1
    Some will say: links are text though :) - or at least think it. And who reads all those text boxes anyway? Nov 16, 2018 at 12:39
  • 1
    @PatrickArtner - LOL No one, as we know. :-) Nov 16, 2018 at 12:59
  • 1
    @Gimby - My preference as well, for exactly that reason. Nov 16, 2018 at 12:59
  • 1
    I'd add or a link as that's the other issue we face often
    – user3956566
    Nov 16, 2018 at 14:27
  • 1
    @YvetteColomb - Doh! Done. :-) Nov 16, 2018 at 14:30
  • "Include code / error messages as well formatted/indented text". Pleeeeeeease! Or something like that.
    – GhostCat
    Nov 16, 2018 at 15:52
  • @GhostCat: Error messages not being exactly formatted is probably the least egregious thing to occur. If the error message is text, at least it can be formatted by someone else later on...it's just a mistake to try and transcribe error messages or anything from an image since it leads to copy errors.
    – Makoto
    Nov 16, 2018 at 15:56

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