I think failing to define acronyms is a violation of just about any style guide out there.
Communication is a majority of engineering so I think these things are very important.
This is an appallingly poor and misguided take, and goes against the most basic rules of writing technical documents. Docs need to be clear, unambiguous, and self-contained. The very first time a acronym is presented, it must be after the full name is presented.
It takes less than a sentence to do the right thing. There is no excuse.
I work with a client who built a web app in... Vue, I think. For unknown reasons they decided that it would be better that the APIs they need to call to live on the same domain. At the same time, the developers decided that the API microservices should not return CORS headers. Instead it was left to operations to hack in CORS headers in the webserver/loadbalancer.
https://addons.mozilla.org/en-US/firefox/addon/access-contro...
because properly configuring the backend is ¨too complicated¨.
Been there, done that.
But I was referring to legacy code (or those whose SPA is stored on the same domain as API endpoints).