25

I was reading the Minimal Reproducible Example page and I noticed that for some reason the mwe acronym is spelled out as "minimal workable example".

However, I believe that "minimal working example" is far more common (e.g. from Wikipedia or The Free Dictionary).

Searching on Google for "minimal workable example" gives ~30 hits versus the ~435'000 hits of "minimal working example".

Even searching on Stack Overflow Meta gives ~5 hits for minimal workable example and ~230 hits for minimal working example.

Therefore, I would suggest the Minimal Reproducible Example page to be modified accordingly.


NOTE: this question is not about what official name should be adopted on Stack Overflow for the concept of "minimal {working | reproducible | complete verifiable | verifiable complete} example" (which received its fair share of attention, perhaps with a somewhat questionable outcome). It is about spelling out the acronym "mwe" as "minimal working example".

8
  • 2
    Good catch, I'd say... Commented Sep 17, 2019 at 19:01
  • 7
    Why not "Minimal, Complete, Verifiable Example"? — Yes, sour grapes. — But why is it "mre" at all if the explanation is "minimal work{ing,able} example"; why isn't it "mwe"? Commented Sep 17, 2019 at 19:12
  • 3
    @JonathanLeffler If it was for me, I would have called the whole page minimal working example or mwe for short. I think this "mwe" acronym is what I've learned first. But regardless of what "official" name is picked up for the page, one could always spell out "mwe" correctly in the text of the page. I am only trying to make this last change happen.
    – norok2
    Commented Sep 17, 2019 at 19:32
  • 1
    Also, might be confused with "meal ready to eat" in military parlance.
    – user2100815
    Commented Sep 17, 2019 at 19:36
  • @NeilButterworth this has been brought up as a positive. Because somehow people who know what a military MRE would, upon seeing the acronym here, immediately figure out it's about code that is prepared and ready to run. I am honestly confused by this specifically because I was confused when I saw MRE and then reading the explanation. It didn't occur to me that MRE = sort of "code ready to be run".
    – VLAZ
    Commented Sep 18, 2019 at 7:47
  • 7
    I disagree with this. It will be misunderstood by a decent percentage of people. Why or how would anyone post a 'working' example of code that presumably doesn't work? 'Workable' implies that there may be an issue with the code, but it's in a state which you can work on it.
    – PaulG
    Commented Sep 18, 2019 at 8:46
  • 4
    @PaulG Will it? I do not find a reference of your perceived meaning in the Merriem-Webster dictionary for workable vs working. On the other hand "working" as "adequate to permit work to be done" and "assumed or adopted to permit or facilitate further work or activity" perfectly fit the concept being conveyed with "minimal {working | reproducible | complete verifiable | verfiable complete} example" from the perspective of whoever is going to tackle the issue presented in the question.
    – norok2
    Commented Sep 18, 2019 at 9:15
  • 2
    I think you're stretching that definition quite hard there! The example you posted for working is in the context of 'a working majority'. Just my opinion, but if someone is looking for help with a bug and you tell them you'll only look at the issue if they can post a 'working example' it's going to cause a lot of confusion.
    – PaulG
    Commented Sep 18, 2019 at 9:23

0

You must log in to answer this question.