[smusamashah]

I think it was Joel Spolsky's book "User Interface Design for Programmers" where one of his strong points was that nobody reads manuals. Documentation isn't any different.

And on the article's point (the title at least), I write stuff for LLM more freely because they will not care if what I have written is complete garbage. I can't do that in the documents I write for fellow humans. They will be read by them and carry more weight, and therefore require much more effort to write. With LLM, all I care about is providing enough context.

May be we just need to ingrain some of that thought process in our for-humans docs.