Lately i have seen many answers to "trivial" questions being just a block of code, which is, I must admit, most of the times very self-explanatory and obvious, but only to people with a bit more knowledge than the newly created 10 rep whatever-beginner.

please compare revision one and revision two. it is not much of a problem to write three lines of explanation, instead of providing a solution, and having OP return for a simple variation of the problem.

Thus I would like to discuss the introduction of a feature:

Dialog-Box with "please consider adding further explanation to you answer", when a submitted answer consists only of a code-block

  • 4
  • Should this mechanism count comments in code as explanation enough? – Mołot Sep 13 '13 at 10:00
  • 3
    @Mołot pff, who writes those? – Bart Sep 13 '13 at 10:01
  • @Bart for example here you can see important explanation as a comment on get_next_steps function. – Mołot Sep 13 '13 at 10:03
  • 4
    Downvote and add a comment when you find those. – Oded Sep 13 '13 at 10:04
  • 3
    Is this "force", isn't it more "suggest" – Richard Tingle Sep 13 '13 at 10:04
  • 1
    @Mołot - I've seen questions where the actual question was in a code comment. And it is often glossed over - people don't read the code comments - they look for the question in the body of the question. – Oded Sep 13 '13 at 10:05
  • @Oded I'm not arguing. I just wanted this aspect covered. And I know I can't tell what people read, I read the comments in the code I'm suggested to use, but hey, I also read leaflets from my allergy drugs for example. – Mołot Sep 13 '13 at 10:09
  • 1
    @Mołot like that? Have to admit, of few hundreds answers I posted at SO and Programmers, only about a handful allowed to keep substantial message within code comments. As a rule, I have to put important stuff outside the code to make an answer readable (answer readability is important because it helps to get upvotes) – gnat Sep 13 '13 at 11:35

Browse other questions tagged .