> It happened astonishingly fast; within about five years a knowledge skill that I had completely taken for granted as a basic requisite in an undergraduate was diminished beyond recognition.
Then the second half
> A good way of writing documentation for human beings today will still be a good way to do it in a few years’ time.
Don't these contradict each other? Documentation that worked well for us who grew up pre-Internet is not working well for "web natives".
Contrast that with the second quote. Good documentation could be in a dusty book in the library or in a SPA. What makes the documentation good isn’t, however, related to people’s ability to navigate information spaces.
Then what's the point? If nobody can use the documentation properly, then the term "good documentation" is meaningless.
You might reasonably ask "in what way".
> this is how documentation is, because this arrangement is part of its integrity, and this is how you must learn to use it and work with it.
The word "integrity" comes up six times. Something about integrity.
Luckily, unlike web natives, LLM's have read lots of documentation cover to cover. Likely a good way to teach LLM's about your product is to write good documentation.