Because of this, docs could already able to be too big to be useful.
"But outlines..." Not helpful since you can't specify to leave out sub-headings. Which means manually editing the outline every update.
That's why I've moved 1000+ pages of docs to Obsidian.md this year. I highly recommend, especially if you might be adhd.
Edit: to anyone interested, this YouTube channel[2] is a great primer on Obsidian.
[1] https://stackoverflow.com/questions/24190618/collapsing-elem...
[2] https://m.youtube.com/channel/UC85D7ERwhke7wVqskV_DZUA/video...