Instead of reading the article I will tell you why the docs are wrong. It's because most teams don't incentivize writing documentation and a lot of them just don't care. The team guru's job security is predicated on knowing the answer to everything so it's a losing proposition for them. If you write good docs about one of these topics, don't be surprised if they try to find a way to punish you for it.

If you're in an SWE job, only write documentation if someone tells you to. Otherwise, just give up.

AI;DR

I block domains on my home network younger than 30 days old. This one's blocked. Slop probable.

this is an ad

“WTFM!” “Write The Freaking Manual!”