It's more like, here's 80 pages of too much information, just give me the API in a tight section here, with an architectural overview.

Usually these tools are used to compress, not fluff.

Honestly, I'd rather just read the bullet points, especially if it gives people more opportunities to lay out hierarchical structure.