Good writing rules can still be used even for repo READMEs where the first time an acronym is used it is spelled out to show what the acronym means. Too many assumptions being made that everyone is going to know it. Sometimes the author can be too inside baseball and assumes anyone reading their README will already know about the subject. Not all devs are literature majors and probably just never think about these things
Yeah, it's a very common initialism for people who work in the space, and have some context.
So? Acronym soup is bad communication.
I miss glossaries.
Good writing rules can still be used even for repo READMEs where the first time an acronym is used it is spelled out to show what the acronym means. Too many assumptions being made that everyone is going to know it. Sometimes the author can be too inside baseball and assumes anyone reading their README will already know about the subject. Not all devs are literature majors and probably just never think about these things
An AI-powered browser extension that shows on hover the most likely acronym meaning, based on context you say?
1 reply →