4 ms·

First rule of writing about something that can be abbreviated: First have some explanation so people have an idea of what you are talking about. Either type out

First rule of writing about something that can be abbreviated: First have some explanation so people have an idea of what you are talking about. Either type out what the abbreviation stands for, have an explanation or at least a link to some other page that explain what is going on. EDIT: This has since been fixed in link, so it is outdated.

diggan 1y ago
> or at least a link to some other page that explain what is going on There is a link to a previous post by the same author (within the first ten words even!), which contains the context you're looking for.
- yxhuvud 1y ago
  A link to a previous post is not enough, though of course appreciated. But it would be something I click on after I decide if I should spend time on the article or not. I'm not going on goose chases to figure out what the topic is.
  - dkdcio 1y ago
    this is a wild position. it would have taken you the same amount of time to type your question(s) into your favorite search engine or LLM to learn what the terms mean as you now have spent on this comment thread. the idea that every article should contain all prerequisite knowledge for anybody at any given level of context about any topic is absurd
reactordev 1y ago
MCP is Model Context Protocol, welcome to the land of the living. Make sure you turn the lights off to the cave. :) It’s pretty well known by now what MCP stands for, unless you were referring to something else…
- klez 1y ago
  I, for one, still need to look it up every time I see it mentioned. Not everyone is talking or thinking about LLMs every waking minute.
  - reactordev 1y ago
    I figured with all the AI posts and models, tools, apps, featured on here in the last year or two that it was a given. I guess not.
  - grim_io 1y ago
    Are you looking up what the abbreviation stands for, or what an MCP is? The first case doesn't matter at all if you already know what an MCP actually is. At least for the task of understanding the article.
    - lsaferite 1y ago
      MCP being the initialism for "Model Context Protocol", the specification released by Anthropic, generally dictates you shouldn't say "an MCP" but simply "MCP" or "the MCP". If you are referring to a concrete implementation of a part of MCP, then you likely meant to say "an MCP Server" or "an MCP Client".
- koakuma-chan 1y ago
  > It’s pretty well known by now what MCP Minecraft Coder Pack https://minecraft.fandom.com/wiki/Tutorials/Programs_and_editors/Mod_Coder_Pack https://minecraft.fandom.com/wiki/Tutorials/Programs_and_edi...
- tronreference 1y ago
  Master Control Program: https://www.youtube.com/watch?v=atmQjQjoZCQ https://www.youtube.com/watch?v=atmQjQjoZCQ
  - lsaferite 1y ago
    I refuse to believe they didn't name the spec with that in mind. Also... that's some dedication. A user dedicated to a single comment.
jeroenhd 1y ago
If you don't know the abbreviation, that can also mean you're not the target audience. This is a blog post written for an audience that uses multiple MCP servers, arguing for a different way to use LLMs. If you need the term explained and don't care enough to throw the abbreviation into Google, you're not going to care much about what's being said anyway. I have no idea what any of the abbreviations in stock market news mean and those stock market people won't know their CLIs from their APIs and LLMs, but that doesn't mean the articles are bad.
jahsome 1y ago
Are you referring to MCP? If so, it's fully spelled out in the first sentence of the first paragraph, and links to a more thorough post on the subject. That meets 2 of the 3 criteria you've dictated.
- yxhuvud 1y ago
  That was not the case when I commented. It has obviously been updated since then.
  - jahsome 1y ago
    Assuming that's true, how would it be obvious to someone who hadn't seen the original?
losvedir 1y ago
If you don't know what "MCP" stands for, then this article isn't for you. It's okay to load it, realize you're not the target audience, and move on. Or, spend some of your own time looking it up. This is like complaining that HTTP or API isn't explained.
- mattacular 1y ago
  It's not really like your examples because MCP has been around for about 1 year whereas those others have been around for decades and are completely ubiquitous throughout the software industry as a result.
- AznHisoka 1y ago
  The difference is those terms are ubiquitous terms after 20 years of usage. MCP is a relatively new term that hasnt even been around for a year or so
- DrewADesign 1y ago
  I think this issue seems completely straightforward to many people… and their answer likely depends on if they know what MCP means. The balance isn’t really clear cut. On one hand, MCP isn’t ubiquitous like, say, DNS or ancient like BSD. On the other, technical audiences can be expected to look up terms that are new to them. The point of a headline is to offer a terse summary, not an explanation, and adding three full words makes it less useful. However, that summary isn’t particularly useful if readers don’t know what the hell you’re talking about, either, and using jargon nearly guarantees that. I think it’s just one of those damned-if-you-do/don’t situations.
- bityard 1y ago
  Textbook example of gatekeeping if I ever saw it.
cgriswald 1y ago
Just so folks who want to do this know, the proper way to introduce an initialism is to use the full term on first use and put the initialism in parentheses. Thereafter just use the initialism. Always consider your audience, but for most non-casual writing it’s a good default for a variety of reasons.
- mdaniel 1y ago
  You're welcome to do that in print media, but on the web the proper way is the abbr element with its title attribute <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/abbr https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...>. Related to the distinction, I'd bet $1 there's some fancy CSS that would actually expand the definition under @media print I can attest the abbr is also mobile friendly, although I am for sure open to each browser doing its own UI hinting that a long-press is available for the term
  - cgriswald 1y ago
    From your source: > Spelling out the acronym or abbreviation in full the first time it is used on a page is beneficial for helping people understand it, especially if the content is technical or industry jargon. > Only include a title if expanding the abbreviation or acronym in the text is not possible. Having a difference between the announced word or phrase and what is displayed on the screen, especially if it's technical jargon the reader may not be familiar with, can be jarring.
  - crazygringo 1y ago
    Please read your own link. It literally says to put the definition in parentheses (same as print) on first use. Second paragraph. <abbr> is not what you seem to think it is. But the "typical use cases" section of your link does explain what it's actually for.
  - jethack 1y ago
    Sadly abbr with title doesn't work at all on mobile Chrome [1] or Firefox [2]. Probably not Safari either, since long press on mobile means "select text" so you'd have to do some CSS trickery (and trying to hit a word-sized target with a finger is quite annoying). [1] https://issues.chromium.org/issues/337222647 https://issues.chromium.org/issues/337222647 -> https://issues.chromium.org/issues/41130053 https://issues.chromium.org/issues/41130053 [2] https://bugzilla.mozilla.org/show_bug.cgi?id=1468007 https://bugzilla.mozilla.org/show_bug.cgi?id=1468007
bgwalter 1y ago
"MCP" is the new "webscale". It can be used to write philosophical papers about LLMs orchestrating the obliquely owned ontologies of industrial systems, including SCADA systems: https://arxiv.org/html/2506.11180v1 https://arxiv.org/html/2506.11180v1 SCADA systems got famous, because they previously required STUXNET to be hacked. In the future you can just vibe hack them.
owebmaster 1y ago
If you are looking for a definition, you should go for beginners article, not advanced.

diggan 1y ago

> or at least a link to some other page that explain what is going on There is a link to a previous post by the same author (within the first ten words even!), which contains the context you're looking for.

yxhuvud 1y ago
A link to a previous post is not enough, though of course appreciated. But it would be something I click on after I decide if I should spend time on the article or not. I'm not going on goose chases to figure out what the topic is.
- dkdcio 1y ago
  this is a wild position. it would have taken you the same amount of time to type your question(s) into your favorite search engine or LLM to learn what the terms mean as you now have spent on this comment thread. the idea that every article should contain all prerequisite knowledge for anybody at any given level of context about any topic is absurd

reactordev 1y ago

MCP is Model Context Protocol, welcome to the land of the living. Make sure you turn the lights off to the cave. :) It’s pretty well known by now what MCP stands for, unless you were referring to something else…

klez 1y ago
I, for one, still need to look it up every time I see it mentioned. Not everyone is talking or thinking about LLMs every waking minute.
- reactordev 1y ago
  I figured with all the AI posts and models, tools, apps, featured on here in the last year or two that it was a given. I guess not.
- grim_io 1y ago
  Are you looking up what the abbreviation stands for, or what an MCP is? The first case doesn't matter at all if you already know what an MCP actually is. At least for the task of understanding the article.
  - lsaferite 1y ago
    MCP being the initialism for "Model Context Protocol", the specification released by Anthropic, generally dictates you shouldn't say "an MCP" but simply "MCP" or "the MCP". If you are referring to a concrete implementation of a part of MCP, then you likely meant to say "an MCP Server" or "an MCP Client".
koakuma-chan 1y ago
> It’s pretty well known by now what MCP Minecraft Coder Pack https://minecraft.fandom.com/wiki/Tutorials/Programs_and_editors/Mod_Coder_Pack https://minecraft.fandom.com/wiki/Tutorials/Programs_and_edi...
tronreference 1y ago
Master Control Program: https://www.youtube.com/watch?v=atmQjQjoZCQ https://www.youtube.com/watch?v=atmQjQjoZCQ
- lsaferite 1y ago
  I refuse to believe they didn't name the spec with that in mind. Also... that's some dedication. A user dedicated to a single comment.

jeroenhd 1y ago

If you don't know the abbreviation, that can also mean you're not the target audience. This is a blog post written for an audience that uses multiple MCP servers, arguing for a different way to use LLMs. If you need the term explained and don't care enough to throw the abbreviation into Google, you're not going to care much about what's being said anyway. I have no idea what any of the abbreviations in stock market news mean and those stock market people won't know their CLIs from their APIs and LLMs, but that doesn't mean the articles are bad.

jahsome 1y ago

Are you referring to MCP? If so, it's fully spelled out in the first sentence of the first paragraph, and links to a more thorough post on the subject. That meets 2 of the 3 criteria you've dictated.

yxhuvud 1y ago
That was not the case when I commented. It has obviously been updated since then.
- jahsome 1y ago
  Assuming that's true, how would it be obvious to someone who hadn't seen the original?

losvedir 1y ago

If you don't know what "MCP" stands for, then this article isn't for you. It's okay to load it, realize you're not the target audience, and move on. Or, spend some of your own time looking it up. This is like complaining that HTTP or API isn't explained.

mattacular 1y ago
It's not really like your examples because MCP has been around for about 1 year whereas those others have been around for decades and are completely ubiquitous throughout the software industry as a result.
AznHisoka 1y ago
The difference is those terms are ubiquitous terms after 20 years of usage. MCP is a relatively new term that hasnt even been around for a year or so
DrewADesign 1y ago
I think this issue seems completely straightforward to many people… and their answer likely depends on if they know what MCP means. The balance isn’t really clear cut. On one hand, MCP isn’t ubiquitous like, say, DNS or ancient like BSD. On the other, technical audiences can be expected to look up terms that are new to them. The point of a headline is to offer a terse summary, not an explanation, and adding three full words makes it less useful. However, that summary isn’t particularly useful if readers don’t know what the hell you’re talking about, either, and using jargon nearly guarantees that. I think it’s just one of those damned-if-you-do/don’t situations.
bityard 1y ago
Textbook example of gatekeeping if I ever saw it.

cgriswald 1y ago

Just so folks who want to do this know, the proper way to introduce an initialism is to use the full term on first use and put the initialism in parentheses. Thereafter just use the initialism. Always consider your audience, but for most non-casual writing it’s a good default for a variety of reasons.

mdaniel 1y ago
You're welcome to do that in print media, but on the web the proper way is the abbr element with its title attribute <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/abbr https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/...>. Related to the distinction, I'd bet $1 there's some fancy CSS that would actually expand the definition under @media print I can attest the abbr is also mobile friendly, although I am for sure open to each browser doing its own UI hinting that a long-press is available for the term
- cgriswald 1y ago
  From your source: > Spelling out the acronym or abbreviation in full the first time it is used on a page is beneficial for helping people understand it, especially if the content is technical or industry jargon. > Only include a title if expanding the abbreviation or acronym in the text is not possible. Having a difference between the announced word or phrase and what is displayed on the screen, especially if it's technical jargon the reader may not be familiar with, can be jarring.
- crazygringo 1y ago
  Please read your own link. It literally says to put the definition in parentheses (same as print) on first use. Second paragraph. <abbr> is not what you seem to think it is. But the "typical use cases" section of your link does explain what it's actually for.
- jethack 1y ago
  Sadly abbr with title doesn't work at all on mobile Chrome [1] or Firefox [2]. Probably not Safari either, since long press on mobile means "select text" so you'd have to do some CSS trickery (and trying to hit a word-sized target with a finger is quite annoying). [1] https://issues.chromium.org/issues/337222647 https://issues.chromium.org/issues/337222647 -> https://issues.chromium.org/issues/41130053 https://issues.chromium.org/issues/41130053 [2] https://bugzilla.mozilla.org/show_bug.cgi?id=1468007 https://bugzilla.mozilla.org/show_bug.cgi?id=1468007

bgwalter 1y ago

"MCP" is the new "webscale". It can be used to write philosophical papers about LLMs orchestrating the obliquely owned ontologies of industrial systems, including SCADA systems: https://arxiv.org/html/2506.11180v1 https://arxiv.org/html/2506.11180v1 SCADA systems got famous, because they previously required STUXNET to be hacked. In the future you can just vibe hack them.

owebmaster 1y ago

If you are looking for a definition, you should go for beginners article, not advanced.