21

I've noticed in my short time on TeX.sx that the amount of explanation given in an answer varies greatly.

As a LaTeX beginner I find that answers that provide a bit of explanation in addition to simply the code that provides the solution are much more helpful to me than their terse equivalent.

What is the site policy (if there is one) on how much explanation to provide in answers?

22

Code-only answers are usually avoided, since the value added does not pertain to a wider audience as much as an explanation would. However, the amount of explanation is varied (as you noticed). For example, some people like an answer structured in the form:

Minimal explanation...
some code
Broader explanation...

while others tend to enjoy

Broad explanation...
some code

The former is intended to suit a broad audience (experienced and inexperienced), since the solution is provided without having to wade through "tedious" explanations and reasoning, while still adding value post mortem.

I think your best bet as a questioner is to post a comment to the answered requesting more information. Ultimately you decide where to place your vote (an indication as to the "usefulness" of the answer) and/or select the "most useful" answer. These selections/decision, of course, bestow reputation as a reward. If it isn't useful, then don't vote.

Alternatives could include opening up a chat room and create a discussion around the solution so you can understand it better. This is typically done in the the general chat room since most regulars hang out there and would be willing to help. Or, perhaps as a last resort, ask a follow-up question about the specifics of the solution. However, make sure that you're not just asking for an explanation, because that is best left as an addition to existing answers, in my opinion.

Perhaps some answer(er)s require incentive in order to provide detail. I guess a bounty could be issued for that, usually also garnering more answers from other experienced users. But, posters on this site are usually easy to provide more detail from a comment making this not really necessary.

  • 2
    I would add a 3rd answer template, that I do quite a lot: (1) Minimal explanation, (2) self-commented code (using TeX's %-comments). – yo' Aug 23 '12 at 10:44
  • Personally it's a pain for me to read first a detailed explanation without real example of how work each element of the problem, as well as very complete example where it is difficult to find some code which answers the question, or with a long code which is relevant but hard to understand how each part works. However, I find very useful both brief explanations simply put you on the track of the solution even without a MWE, as is the self-explanatory MWE or not so small, even with non-relevant parts, provided they are widely commented. – Fran Aug 24 '12 at 12:07

You must log in to answer this question.

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