38

I've stumbled a few times across poorly written MWEs as part of questions, and realized recently that my take on what to do (edit it) isn't shared by everyone here (leave the question untouched and put another MWE in an answer). So the question is:
Is it acceptable to edit a MWE and how much?

Being a minimalist and a perfectionist, my personal opinion is that MWEs should be edited to be as minimal as possible, as far as it doesn't modify the behavior the MWE is supposed to show (and they do work!). So unnecessary loading of packages, commands redefinitions, etc. should be removed if they are not part of the issue.

What are your opinions and what is the consensus?

2

1 Answer 1

30

It's not really an answer, but my thoughts are too long for a comment. :)

First of all, I'd like to thank you for all the effort you've put into moderncv and the time spent in helping people here. :)

I really share your worries on some MWE lacking the minimal component. Indeed we have quite a bunch of such examples in our community.

I once stumbled upon one of your edits and, although your changes in the code really reduced it to the minimal example, they were quite significant. I decided to abstain from voting for that particular revision - and then someone else voted.

I'm very happy to see improved questions and answers. We have great TeXnicians around - Heiko, Frank, egreg, David, to name a few - but we also have a lot of TeX newbies. IMHO writing a MWE is also part of the learning process. We have successful stories in which problems were solved by simply trying to come up with a MWE.

I think a good approach would be to ask the OP, via comment, to try reducing the code to a minimal state. I see this as a win-win situation:

  1. The OP can learn from the process and maybe even solve the original problem.
  2. The community will have a concise code and a better question.

I'm also tempted to reduce codes to their minimal form, but I can see the benefits of leaving the questions as they are for a while. As TeX shepherds, we are happier about that one sheep that had a good learning experience than about the ninety-nine that did not need guidance. :)

4
  • 1
    What do we do with the opiniated goats like meee \def\stutterfrequency{3.5Hz} e e e e ?
    – percusse
    Commented Nov 21, 2012 at 11:27
  • 4
    @percusse: ¡Cuidado, llamas! Commented Nov 21, 2012 at 11:37
  • 4
    @PauloCereda Agree, I like the balance of the commenting idea!
    – Xavier
    Commented Nov 21, 2012 at 14:36
  • 1
    @Moderators: Could I, please, upvote this answer ten times? It says, what I am thinking, but not being able to express it in words! Paulo: Here once an waffle ice (grin) for you: <3
    – Speravir
    Commented Nov 21, 2012 at 23:10

You must log in to answer this question.

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