Hacker News Reader

Agreed that the expandable sections feel a little unusual for this type of documentation. They're great for drilling down to particular information, but not so much for skimming or reading straight through.

I might even suggest putting the sub-section navigation in the sidebar a la readthedocs.

Agreed on this.

An Expand All/Collapse All button would also be nice (but not instead of expanding by default-- the whole reason I'd be reading those documents is to read the stuff in the collapsed sections).

Agreed, it's tedious to click on each item to expand the page. Either expand it by default or provide a global switch for that expandability.

Yeah I could definitely do this.

If I were to add a collapse/expand all button would you still prefer for all the sub-sections to be expanded by default?

Yes I think so, the pane on the left already allows the user to control which section they are reading. I would assume that once a reader is in a section they would likely want to read/scan all of it. Excellent work by the way!