2,435 karma · joined October 2, 2019
https://passo.uno
Edit: I guess some commenters misunderstood my message. I'm saying that by serving also the needs of LLMs we might get more resources to improve docs overall.
https://youtube.com/playlist?list=OLAK5uy_njWv6ssGZFL5TYEDOf...
"This wasn’t just about type safety – it was about reducing the mental burden of programming."
The "x wasn't just about n — it was about m" carry a strong LLM smell.
I don't know what's the rationale for not hiring tech writers other than nobody suggesting it yet, which is sad. Great dev tools require great docs, and great docs require teams that own them and grow them as a product.
Yes, developers need to improve writing skills. A good book on the matter is Chris Ward's Technical Writing for Software Developers, which I reviewed here: https://passo.uno/review-technical-writing-software-develope...
They also need to hire technical writers. Did the author know they exist?
And before someone links Yet Another Docs Framework, I recommend taking a different approach: https://passo.uno/beyond-content-types-presentation/