The fourteen lenses
A documentation site can be read fourteen different ways, and each reading finds a defect the others are structurally blind to. Internal linking cannot see a page that was never written. Jobs-to-be-done cannot see a robots rule. Search intent cannot see that a correct page uses a word no reader would type.
Do not run all fourteen. A fourteen-part report is one nobody finishes, and it buries the two findings that mattered. Choosing a lens decides which two to four a given question and a given set of available evidence actually justify.
Each page below has the same shape, deliberately: what the lens exclusively owns and what it explicitly does not, when the pass earns its place, how to grade the evidence it produces, the readings themselves, and a severity table. That sameness is what makes fourteen pages navigable instead of fourteen essays.
Structure, intent and language#
the struggling moment, the forces around it, and the belief with no page.
the page ranks, and it is the wrong shape for the question.
the page that is correct and unreachable, because nobody types those words.
whether the corpus reads as an authority on one topic.
one question asked N times with one variable changed.
the defect that lives between the pages.
the corpus as a graph, and the component nobody can reach.
Citation, trust and the market#
the reader who got the answer and never arrived.
the corpus that is correct and still not believed.
the gap that is yours, and the one that is only theirs.
whether anything here is worth citing, and what already cites it.
the data the product already has and never publishes.
the reader whose answer is a widget, not a paragraph.
the segment this documentation has never spoken to.