Comment by thesuitonym

5 years ago

Even better, just use the abbr tag. It's well supported and doesn't rely on an outside source to tell your readers what you're talking about.

“It’s well supported”, yet on latest mobile Safari, it doesn’t appear to work at all. This w3 demo code does not show me the full name anywhere in the rendered content -https://www.w3schools.com/tags/tryit.asp?filename=tryhtml_ab...

Relevant to the parent here, I prefer to use a link because it is more commonly expected and it gives me the opportunity to refer to a quality source for an in-depth explanation of what I'm referencing.

It is especially useful when writing a technical document that utilizes multiple products/stacks/terms. Creating links to quality sources for those items gives someone new to the content a good source to go deeper into those pieces while allowing me to focus the article on the specific aspect I'm writing about.

  • This is how you do that:

        Conflict-free Replicated Data Types (<a href="...">CRDT</a>)
    

    ...then you use "CRDT" for the rest of the document.

Wow, that's awesome! Thanks for the tip!

A lot of people seem to be questioning why you'd need this when you could just provide a full link. Personally I read a lot of technical documentation and having acronyms written out in full would almost always be enough. Otherwise the whole document is likely over my head, or it's just a bad acronym.