@nolan Interesting thoughts.

So far I was mostly annoyed with realising too late after started reading it that the doc was written using LLMs. The feeling that no care has been put to it is offensive when I've become used to great documentation such as the one you've created.

The point of the documentation wasn't to be just a reference.

Maybe we are losing something that is not important. Maybe not.

@augustohp @nolan I’ve tried to come up with some sort of clever name for the “anti-documentation” that gets written for LLMs and then LLMs are capable of spitting so much of it back.

Good documentation is “here’s what the thing does” and much more importantly *how* and *why* it does it. The best documentation also includes “what we learned along the way”. The anti-documentation is “here’s what we want the thing to do” but often no clear indication of *how* or *why* and no learnings.