146

Working through the review queue, I am finding it very common to need to refer new users who's questions are being close-voted to the Minimal Complete Verifiable Example document. It would be a boon to have a shortcut for that link, automatically translating [mcve] (brackets included) to the equivalent of typing [Minimal Complete Verifiable Example documentation](https://stackoverflow.com/mcve)

Related MSE post: Add data.SE style "magic links" to comments

11
  • 26
    MCVE is pretty regrettable, SSCCE was the mainstream term before StackExchange wrote the help center page. With a very good web site that explains what it means. Blindly translating it is a problem, MCVE is ambiguous. Mainstreet Credit Verification Engine is pretty popular. Although we probably don't have to worry about programmers asking about Multimedia Collaborative Virtual Environments or Milk for Cheese Value Equivalent :) Commented May 18, 2015 at 10:03
  • 16
    @HansPassant: Sometimes, Silly Children Can't Educate :( Commented May 18, 2015 at 11:48
  • 13
    @HansPassant are you seriously suggesting that because MCVE is an acronym that might mean something else somewhere else, that would be a reason not to provide it as a shortcut for typing "[ Minimal Complete Verifiable Example ] ( http://stackoverflow.com/mvce )" in a comment? This isn't "blind translation", this is translation of a very specific code in a very specific circumstance. Find me one example of a comment in StackOverflow where someone typed [ mcve ] and didn't mean what I prosed it to shortcut to and ... I'll be danged thats for sure. Commented May 18, 2015 at 13:00
  • 1
    Yes I'm serious, credit card processing is a common programming task. Of course I can't give you an example, there are entirely too many MCVE search hits. In general, silently altering typed text is rather evil and universally despised. Best way to help somebody is by not using jargon. Commented May 18, 2015 at 13:08
  • 29
    @HansPassant The shortcut being proposed is not MCVE. It is [mcve] - with square brackets, in line with all the other magic shortcuts to the help centre... I don't think that shortcutting [mcve] can be argued to be more evil than shortcutting [help], which is already there ! Commented May 18, 2015 at 13:12
  • 1
    Okay, I edited the question to make that a bit more obvious. Commented May 18, 2015 at 13:25
  • Meanwhile, a workaround is to add this very question (or this one) to your favorites, and consult it each time you want to insert the link. Very tedious.
    – anatolyg
    Commented May 18, 2015 at 13:44
  • Unless/until this is implemented, you can always use something like PhraseExpress or AutoHotkey. Commented May 19, 2015 at 2:20
  • 2
    I wish I could just keep up-voting this. I find myself typing this a LOT, so much so that I keep Notepad open with a full comment that I can just copy in...
    – Barry
    Commented May 19, 2015 at 2:35
  • @Barry the best thing to do is supply an answer to this question stating your position on it (affirmative) and the rationale why. See meta.stackoverflow.com/questions/294654/… to confirm that this is "the best thing to do". Commented May 19, 2015 at 4:43
  • status-completed? Wooo!
    – Cerbrus
    Commented Jul 16, 2015 at 10:12

2 Answers 2

36

This works now (only on Stack Overflow). The link text is "Minimal, Complete, and Verifiable example" (which matches the title of https://stackoverflow.com/help/mcve).

6
  • 3
    test at SO: passed! Test at MSO: [mcve]... fails as expected
    – gnat
    Commented Jul 16, 2015 at 10:42
  • 3
    Don't forget to update Markdown editing help / comment formatting.
    – Mogsdad
    Commented Jul 24, 2015 at 1:05
  • 1
    @Mogsdad I have, at the same time I made this change. You're just looking at the wrong one. See here
    – balpha StaffMod
    Commented Jul 24, 2015 at 5:00
  • @balpha how does it work exactly? I find myself referencing a good number of questions per day to the MCVE documentation. I wonder if it would be worth while to have a more relevant call to action to the doc when certain users are asking a question. These users could be: new users, users under a certain amount of reputation, users whose questions have been closed due to MCVE reasons in the past... etc. Any thoughts?
    – AGE
    Commented Jan 20, 2016 at 14:51
  • The link target is http://stackoverflow.com/help/mcve - I think it would be better without explicit protocol as //stackoverflow.com/help/mcve, or (better) just /help/mcve (as I normally write, by hand) so as not to annoyingly downgrade HTTPS to HTTP for no good reason. Saves a few valuable bytes, too. :-) Commented Mar 10, 2016 at 9:15
  • Late to the party here, but isn't is useful to include it in the question body or some other place that new users will see / read it before they write the question? (maybe even something similar to github issue templates)
    – Sagiv b.g
    Commented Sep 28, 2018 at 12:16
68

It would be better to have [mcve] auto-convert to [Minimal, Complete, Verifiable Example](http://stackoverflow.com/help/mcve) spelled out, since user Hans has pointed out that there is apparently some confusion, and esoteric acronyms aren't as helpful to people as words, anyway.

I didn't know what MCVE or SSCCE stand for before I came here (I still don't know what SSCCE stands for, actually), and I sometimes even mess up the order of the acronym... so I wouldn't expect newcomers (ostensibly the group this feature would benefit) to know, either.

7
  • 10
    It stands for Short, Self Contained, Correct (Compilable), Example Commented May 18, 2015 at 13:40
  • And before that, there was How to ask questions the smart way, which is still worth reading. Commented May 20, 2015 at 0:11
  • 2
    I have a trivial shell script that generates two lines of output: MCVE ([Minimal, Complete, Verifiable Example](http://stackoverflow.com/help/mcve)) SSCCE ([Short, Self-Contained, Correct Example](http://sscce.org/)), which produces MCVE (Minimal, Complete, Verifiable Example) and SSCCE (Short, Self-Contained, Correct Example) when not escaped. It isn't hard to use it when I need it. This is not intended to dismiss the suggestion; it is simply an observation that it is not hard to make it easy for yourself even without help from SO. Commented May 20, 2015 at 0:17
  • 3
    @JonathanLeffler a shell script to generate a hard-coded string?
    – Blorgbeard
    Commented May 20, 2015 at 2:39
  • @Blorgbeard: Yes; it's easy for me to run (it's called sscce since it pre-dates the MCVE page). I can copy'n'paste (and if put the effort into it, I could almost certainly have the command copy into the copy'n'paste buffer, but that would be less portable). It isn't exciting; it is effective for me. It actually contains two echo commands, though it could be written with a here-document and cat instead. Anyway, how else would you write it? A C program would be overkill. An alias would be silly; I don't use it enough to warrant it being an alias. Commented May 20, 2015 at 2:42
  • 1
    I would just have a line in my stuff.txt that stays open in Notepad++, but I don't spend that much time in the shell. To each their own, I'm sure.
    – Blorgbeard
    Commented May 20, 2015 at 2:48
  • What's Notepad++? :D Yes, each to their own. Commented May 20, 2015 at 4:45

You must log in to answer this question.

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