[oblio]

I find it funny that we had to invent tools that will replace, say, 20%+ of developers out there to finally have developers to write docs :-))

[baq]

The difference today is the docs are being read. In the before times, unless you were building a foundational library, docs would get updated when a presentation was needed to announce a great success, or maybe not even then. Nowadays if you want coding agents to be efficient, doc quality is paramount.

IOW there’s very clear ROI on docs today, it wasn’t so earlier.

[oblio]

I guess also the opposite is true, if a developer wants job security, not writing docs (and writing obfuscated code) is still the way to go :-p