Progressive Disclosure¶
Core Idea¶
Reveal information or options in stages calibrated to the receiver's current need-to-know, each stage sufficient to act on, with deeper layers reachable on demand behind a visible affordance — the visible path down is what separates disclosure from concealment.
How would you explain it like I'm…
Lift-the-Flap
A Little at a Time
Layers With a Visible Path
Broad Use¶
- Human-computer interaction: Menus that show common options first with "More…", wizards that ask one question per screen.
- Teaching: Spiral curricula that introduce a concept simply, then return with added structure, then with full formal apparatus.
- Legal communication: Plain-language summaries layered on statutes; "key terms" boxes atop full contracts.
- Software architecture: High-level facade calls delegating to lower-level primitives reachable only when needed.
- Scientific writing: Abstract, then introduction, then methods, then full detail — each layer self-contained.
- Onboarding: New hires meet procedures, then policies, then exceptions, then underlying reasoning, on a schedule matched to need.
Clarity¶
Separates information available from information presented, so a system can be fully transparent while disclosing progressively — and makes the dark pattern of burying consequential content nameable.
Manages Complexity¶
Sizes each layer to a coherent unit of decision and defers the rest, so the receiver's working memory is spent only on what the current task needs.
Abstract Reasoning¶
Reasoning becomes layered sufficiency: the audit discipline is test by stopping — if a receiver who halts at a layer is materially worse off, it is truncation, not disclosure.
Knowledge Transfer¶
- UI → curriculum: "Layer by task, not topic" applies identically to a menu, a course module, a contract section, and an API surface.
- Software → legal documents: "Make the affordance honest" — hidden tabs, missing "advanced" controls, and unmarked exceptions break the contract everywhere.
- UI defaults → curriculum core: "Default well" carries from sensible UI defaults to a curriculum's "what every student must know."
Example¶
A spiral curriculum on recursion: a first pass ("a function that calls itself") is sufficient to trace a countdown, "we will return to this" is the honest affordance down, and the full formalism is hidden-but-reachable in later passes.
Relationships to Other Abstractions¶
Current abstraction Progressive Disclosure Prime
Parents (1) — outgoing typed relations
-
Progressive Disclosure is a kind of Layering Prime
Progressive_disclosure is 'the specific, receiver-facing SPECIES of layering' defined by three added constraints (per-layer sufficiency, minimum-sufficient visible layer, a visible affordance down) generic layering lacks.
Children (2) — abstractions linked here by typed relations
-
Social penetration theory Domain-specific is a kind of Progressive Disclosure
It remains its own entry because its identity is fixed by the relationship and participants, communication medium and period, disclosure topic, breadth and depth coding, reciprocity, rewards and costs, intimacy outcome, temporal sequence, culture and privacy and competing causal explanation.
-
Progressive-Disclosure Failure Domain-specific presupposes Progressive Disclosure
Progressive-Disclosure Failure presupposes an attempted Progressive Disclosure schedule whose layer exposure is mistuned to users and tasks.
Hierarchy path (1) — routes to 1 parentless root
- Progressive Disclosure → is a kind of Layering
Not to Be Confused With¶
- Progressive Disclosure is not Information Hiding because disclosure keeps deeper content advertised and reachable, whereas information hiding encapsulates internals the consumer should never need to see.
- Progressive Disclosure is not Layering because it is the receiver-facing species with per-layer sufficiency and a visible affordance, whereas generic layering needs none of those.
- Progressive Disclosure is not Abstraction because it defers detail that remains fully present, whereas abstraction discards detail to form a simpler concept.