A week ago, I had an idea: change a URL with thousands of outstanding uses and try to replace an awkward initialism with... Another awkward made-up word.
...Ok, that was... not a great idea. Fortunately, many of you generously donated your time to point out just how not-great that idea was, and some of you even suggested better ideas. Here's one from Cœur:
And for most people to understand it, maybe we could have the URL being a full title:
/help/minimal-reproducible-example
and everything else (mcve, reprex, ...) being redirects to such clear title. This is a common practice for instance on Wikipedia where they define shortcuts for frequent URLs.
That's, uh... A really good idea. It's simple, it results in a URL that consists of actual English words, and leaves us free to refer to it however we want.
So after a bit of discussion last night & this morning, this is what we've done:
- The canonical URL for the help page is now /help/minimal-reproducible-example - no more guessing what it refers to.
- /help/mcve and /help/reprex both just redirect to /help/minimal-reproducible-example - no broken links.
- "Magic" links have been added for [reprex], [repro], [mre], [example] and [mcve] that all point to /help/minimal-reproducible-example - use any of those in comments and they'll be turned into a link.
- Added "mvce", "repro", "reprex", "min-reprex" and "example" to the footer of the help page itself, to aid search engines (especially our own) in finding the right page.
Still TODO: update /editing-help, look for bugs
I know this probably seems like... A thing of minor importance, a bikeshed discussion, even a waste of time. But while the naming may not be that important in the grand scheme of things, helping new askers find this information is paramount: the success rate for folks who read this page before asking is significantly improved over those who do not, and that translates to less frustration for them and for everyone who takes the time to try and help them. Anything we can do to make learning this stuff easier, less confusing and less time-consuming stands to have an outsized impact long-term.
So thanks again for all of your feedback over the past week, and for your patience. Because of that feedback, we've arrived at a solution better than any I was able to come up with on my own - it's collaborative work like this that makes me love this place.
[mwe]
?repr
andex
going to be removed?