"Documentation - or, as I like to call it, lies."
After a certain number of years you learn that source code comments so often fall out of synch with the code itself that they're more of a liability than an asset.
"Documentation - or, as I like to call it, lies."
After a certain number of years you learn that source code comments so often fall out of synch with the code itself that they're more of a liability than an asset.
At my last place the docs were in the repo with the code, and if you didn't update the docs in the same PR as the code it wouldn't get approved.
My current place? It's in Confluence, miles away from code and with no review mechanism.
“There’s lies, damn lies, and datasheets.”
Although, “All datasheets are wrong. Some datasheets are useful.”