4 ms·
When I write, I typically DO spell these things out. > We accepted a pull request ("PR") for our continuous integration ("CI") server. As a result, CI will now
by mcherm 4y ago
When I write, I typically DO spell these things out.
> We accepted a pull request ("PR") for our continuous integration ("CI") server. As a result, CI will now automatically trigger a canary release instead of the old blue-green deployment process, except on AWS where canary releases are not supported.
Note that there's no real interruption to the flow of the writing, as I only spell it out the first time it is mentioned. Nor do I stop to explain what "pull-request" means -- the full name (unlike the acronym) is enough to perform a search on the topic and read about it if needed. And I don't do this universally: everyone I know uses "AWS" instead of "Amazon Web Services" and even pronounces it that way in conversation, so I don't bother explaining that one.
- krisoft 4y agoYou also don’t bother explaining what canary releases are. Which is weird. Who is your intended audience with that example? Is this some imaginary audience who knows and cares about canary releases and blue-green deployment but somehow missed out on PRs and CI?
- wizofaus 4y agoYou can at least easily Google "canary release" I suppose, in a way that's going to give a clear answer vs googling "PR" or "CI" (which will likely tell you PR means public relations and CI is the symbol for a "curie"/unit of radiation).
- yunwal 4y agobut it would be impossible to google FOMO...
- wizofaus 4y agoNot sure what your point is, I'm defending not spelling out things that are easy to google. FOMO and "canary release" both are, while CI/PR, not so much. In principle if you were writing something for an audience that may or may not have heard of continuous integration or pull requests, at least spelling them out makes it easier for them to look up their meanings. I don't actually think it's a big deal either way, though it's surprising how often people use abbreviations and just (incorrectly) assume others know what they mean. If you're writing on any sort of interactive platform, being around to explain them if asked is probably sufficient though.
- Swizec 4y ago> everyone I know uses "AWS" instead of "Amazon Web Services" and even pronounces it that way in conversation, so I don't bother explaining that one Maybe that’s how this author’s bubble feels about FOMO. I for one don’t think I’ve ever heard the full version of “FOMO” in conversation. Similarly to how everyone I know says “pee-arr” and may not even remember it’s short for something.
- kbelder 4y agoI just wanted you to know: You are completely correct and everybody arguing with you is wrong.