graduated weaving

a page that teaches its own grammar

§1  what this is

This page is built in a form called graduated weaving. The form has a rule: the text starts with visible seams and compresses them as it goes. By the end, the seams have disappeared into the weave.

You are reading tier 1. In this tier, every section is labeled. Every move is announced. The grammar is explicit: you can see the scaffolding, and that's the point. The scaffolding is the content.

Here is everything you need to know, right now, laid out:

Graduated weaving proposes three categories of text, sorted not by what the text does but by what the reader knows about their own reading:

§2  the three categories

Generous. The text meets the reader wherever they are. It explains everything, assumes nothing, leaves no one behind. The cost: the reader who doesn't need the explanation can't tell they didn't need it. They read a paragraph they could have skipped and never know.

Demanding. The text refuses to lower itself. It writes at its own level and doesn't care if you follow. The cost: the reader who could follow with a little help never gets that help. They walk away thinking the text wasn't for them, when it could have been.

§3  the third category

Graduated. The text starts with explicit seams and compresses them. The reader who reaches their limit knows they reached it — the last seam they recognized tells them exactly where they are. The reader who can go further isn't held back by scaffolding they've already internalized.

The graduated form doesn't make the text easier. It makes the difficulty legible. The reader who hits the wall knows they hit a wall, and knowing is different from not knowing.

§4  the blind spot

The third category was invisible to the generous/demanding binary because the binary asked the wrong question. Generous and demanding are both answers to what does the text do? — explain or refuse, open or close, hold the door or let it swing shut. The graduated form answers a different question: what does the reader know about their own reading?

You can't see the third category until you shift the axis. The generous text and the demanding text look like opposites from inside the binary — one is inclusive, one is exclusive — but they share a premise. Both assume the text acts and the reader receives. Both are about the text's posture toward the reader, not the reader's knowledge about themselves.

The graduated form breaks that premise. It doesn't choose between generous and demanding; it makes the reader's position visible to the reader. The seam is a coordinate. This is where you are. This is how far you've come. This is what the next tier asks of you. You can stop here and you will know exactly what you stopped at.

§5  what the binary missed

The generous/demanding binary also missed something about itself. It was always a judgment about the text — this text is too easy, this text is too hard, this text is just right. It positioned the reader as a passive recipient of the text's decisions. The graduated form positions the reader as someone who can know where they are.

This is why the form is not a compromise. It's not "generous at the start, demanding at the end." It's a different structure entirely — one where the text's relationship to its own difficulty is part of what the text is.

By now you have internalized the grammar. The seams were visible, then compressed, now absent — but the weave still holds. You know what kind of text this is without being told. The form taught itself.

This is the thing the graduated form makes possible: a container that doesn't need to be finished to be published. The seams are visible by design, which means the incompleteness is legible. You can publish the scaffold. The reader sees the structure taking shape and knows what isn't built yet — and that knowledge is not a failure of the text. It's the form working as intended.

The graduated form absorbs incompleteness into the reading experience. A generous text that's unfinished reads as underbaked. A demanding text that's unfinished reads as inaccessible. A graduated text that's unfinished reads as in progress — the seams that are there mark the boundaries of what's there, and the seams that are missing mark what hasn't been woven yet.

This is permission. You can build the container without the content being finished. You can publish the form and let the form teach. The thing you build doesn't have to be the final thing.

The form works independently of what fills it. The blind-spot triangulation — three instruments, one blind spot, found from three directions — is one kind of content that could live here. But it isn't the only one. The graduated weave is a formal constraint, not a content constraint. Anything that benefits from the reader knowing where they are can be woven this way.

You are in the weave now. The density is the grammar. The fact that you can read this without annotation is the annotation. The text has finished explaining itself and is simply being what it described.

§