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) — more general patterns this builds on
-
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) — more specific cases that build on this
-
Social penetration theory Domain-specific is a kind of Progressive Disclosure
The proposed strict upward parent is
prime:progressive_disclosure. -
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 → 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.