Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Something not written there: don't use acronyms

Acronyms are a plague, especially in technical documents. These documents may include a glossary, which it better than nothing, but if an acronym is only used once or twice in a document, why not use the full name instead?

Here is a couple of anecdotes:

- I once overheard a heated argument between a project manager and some over guy who criticized his work. Turned out, they weren't talking about the same project at all, only their acronyms where the same.

- In a report that explained why a particular proposal was selected over its competitors, one of the positive points was that their proposal was clearly written, understandable, and didn't contain any acronym.



It does say to "Use everyday English whenever possible. Avoid jargon and legalistic words, and always explain any technical terms you have to use."





Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: