The version of the documentation which I would very much like to see would be a Literate Programming version where all the code is explained from the ground up.

Apparently, this can actually assist the LLM:

https://silly.business/blog/we-should-revisit-literate-progr...

as discussed here previously:

https://news.ycombinator.com/item?id=47300747

That's a great idea. I wonder if any major library (or language) has attempted a version their site in that style.

I'd love to experiment with this myself.