3

Stack Overflow's version of How to Answer doesn't mention the word "code" once. I'd love to see an excerpt about code-only answers somewhere in there.

I don't know exactly what would belong, so this is mostly boilerplate, but something like this might be fine:

Add more than just code

Code is an essential part of many good answers, but it's not the only essential part. When possible, please pair your code with a detailed explanation, including (but not limited to) what you changed and why you changed it.

7
  • Is this a thing? I assumed it was possible because of the different copies of /help/gen-ai-policy, but I wasn't totally sure.
    – Anerdw
    Commented Aug 19 at 7:08
  • 1
    I'd expand the last sentence with something in the spirit of "Even if the workings of code seems obvious to you, that may not be the case for less experienced users."
    – A-Tech
    Commented Aug 19 at 7:14
  • I would prefer having a positive approach mentioning that explanations etc make a good post, not a negative approach starting from code-only. The negative approach easily makes bad content seem okay by noting everything else optional. Even if the current draft has one sentence to clarify code is optional, all the rest heavily goes towards emphasising how important code is an even implies code-only is okay; "what you changed and why you changed it" also applies only to a very limited set of Q&A. Commented Aug 19 at 9:16
  • For example, a paragraph listing some important features of good answers would highlight options without focusing on one. Aside from example code, obvious contenders are including explanations and important references. Commented Aug 19 at 9:22
  • 2
    FWIW, the "How to Answer" is the exact same on some other SE pages I just checked. It doesn't seem to be adjusted for the specific page at all. Commented Aug 19 at 9:58
  • Yeah, that's what I noticed too. I don't know if that's an observation or a rule, though.
    – Anerdw
    Commented Aug 19 at 13:10
  • I like your wording and wouldn't add, subtract, or change a word. Commented Aug 19 at 17:17

0

You must log in to answer this question.

Browse other questions tagged .