Thanks. I want to restate: I respect the idea and the ambition. I'm reacting to this feeling I get when there is a lot of text and documentation (and often code) in a thing, stated in the particular style that Claude and other agents do. It asks a lot of the reader's time, when often there is no guarantee that it is internally consistent or (as noted in some other threads here) accurate. My mind wants to work through the text and understand, but there is no guarantee that for invested time in the length of text, I will reach a coherent place.
To put it another way: if a thing is written by a human from scratch, and there is a lot of text (often not the case, because things like this are built iteratively, in the open, so they reach eyeballs before that point), I can pretty quickly ascertain whether the person knows their stuff and if it is worth my time to continue to try to reach understanding with them, to learn from the coherent vision that they have created and are trying to communicate.
Or, if they are the ramblings of a lunatic, I am hopefully able to ascertain that pretty quickly and move on.
In the case of agent-written text at this volume, it feels written to fool the reader into reaching the first case, without the guarantees of the coherent vision. Maybe that gets better with time, but for me, for now, it's enough to note with interest and move on for now.
I'm updating the copy of the page to make it extremely clear that it's built using AI so that we can move past that point.