Skip to main content
3 of 4
edited tags
Shog9
  • 159.4k
  • 177
  • 1.2k
  • 1.2k

Can we please get the "How to create an MCVE" help page updated, to state that a link to a GitHub project is generally NOT an acceptable MCVE?

I'm seeing more and more questions where the asker posts an excerpt of code, that by itself is not runnable, with a link to a GitHub repo and... that's it. (In some of the more egregious examples, there isn't even an excerpt.)

Unsurprisingly, most of these questions are terrible trash that quickly get closed, which is good - but it would be far better if they were never asked at all. To that end, adding guidance along these lines to the How to create a Minimal, Complete, and Verifiable example help page would assist in this*.

Something along the lines of:

Linking to a GitHub repository containing code with the issue you're posting about is generally not an acceptable substitute for an MCVE for the following reasons:

  • Cloning your code and all its dependencies is a significant investment of time and effort, which is likely to deter people from answering your question
  • Should the repository be deleted, or if GitHub is down, the context of the question will be unavailable, which makes it useless to others
  • (other points smarter people than me will come up with)

Additionally - and here's the big ask - if we could get the "Ask a Question" form to pop up a validation tooltip linking to "How to create an MCVE" when it detects a GitHub repo link in the body of a question, that would be great.

* In an ideal world where people actually read that page before asking terrible questions, of course.

Ian Kemp
  • 29.8k
  • 12
  • 116
  • 167