These notes are presented as collapsible outlines rather than flat
documents. This page explains why.
The problem with linear documents
Most written content assumes sequential reading. You start at the top
and work your way down. But most readers don't do that. They scan,
looking for the part that's relevant to them, and then they read that
part closely.
A flat document makes scanning hard. You have to scroll through
everything to find the section you want. Headers help, but they only go
so far when the document is long.
What an outline gives you
A collapsible outline shows the structure of the content at a glance.
You can see every section and subsection without scrolling through the
prose. Then you expand what interests you and skip what doesn't.
This changes the reading experience from "I have to get through this" to
"I'll pick what's useful." For notes and reference material, that's a
better fit than a linear narrative.
Why this format for these notes
The notes on this site are meant to drive discussion, not to be read
cover to cover. Each section is a position that can be engaged with
independently. The outline format makes that easy: collapse everything,
expand the section that provokes you, and go from there.
There is also a link toggle on some pages. Turning links off strips the
references and lets you read the claims on their own terms. Turning them
back on shows where the thinking came from. The content should hold up
either way.
How it works
Click any heading to collapse or expand it. That's it. No accounts, no
JavaScript framework, or server is required. The publisher builds each
page as static HTML with shared CSS and a small script for the view and
outline controls.
These notes are presented as collapsible outlines rather than flat
documents. This page explains why.
▸
The problem with linear documents
Most written content assumes sequential reading. You start at the top
and work your way down. But most readers don't do that. They scan,
looking for the part that's relevant to them, and then they read that
part closely.
A flat document makes scanning hard. You have to scroll through
everything to find the section you want. Headers help, but they only go
so far when the document is long.
▸
What an outline gives you
A collapsible outline shows the structure of the content at a glance.
You can see every section and subsection without scrolling through the
prose. Then you expand what interests you and skip what doesn't.
This changes the reading experience from "I have to get through this" to
"I'll pick what's useful." For notes and reference material, that's a
better fit than a linear narrative.
▸
Why this format for these notes
The notes on this site are meant to drive discussion, not to be read
cover to cover. Each section is a position that can be engaged with
independently. The outline format makes that easy: collapse everything,
expand the section that provokes you, and go from there.
There is also a link toggle on some pages. Turning links off strips the
references and lets you read the claims on their own terms. Turning them
back on shows where the thinking came from. The content should hold up
either way.
▸
How it works
Click any heading to collapse or expand it. That's it. No accounts, no
JavaScript framework, or server is required. The publisher builds each
page as static HTML with shared CSS and a small script for the view and
outline controls.