Text lens

Added · Last updated

… a document already says what it needs to say, but this actor needs it at a different length or reading level: a help article for someone new to the product, a clinical paper for a patient, or a post in a second language. Rewriting the original for one reader makes it worse for the rest, so the view adapts the phrasing or length for this actor while leaving the source text intact. A text lens helps complete help, where the same documentation serves actors with very different background knowledge, and supplies the coarser text levels that semantic zoom and focus and context step through when operating on prose.

Problem

A single text often serves actors with different background knowledge, reading fluency, or available time, and the same actor may need a quick summary first and full detail next. One fixed version compromises across all of them, while authoring separate versions for every audience and length multiplies what the author has to write and keep up to date.

Five forces shape how a text can be adapted on demand:

  • Fixed authoring vs. variable reading depth: systems like StretchText let actors expand or collapse passages by level of detail, but rarely saw adoption because authors had to write and maintain every level by hand. Generating levels on demand removes that authoring bottleneck.
  • Fit vs. fidelity: the further a generated version moves from the source phrasing, the more likely it is to drop qualifiers, soften claims, or introduce errors. In clinical research summaries, generated plain-language versions frequently omit the study population or comparator.
  • Explicit selection vs. automatic adaptation: the system can infer some needs from role or account settings, but cannot reliably guess an actor’s familiarity with a specific topic. Over-simplifying has a cost: readers who already know a subject tend to overlook caveats and study limitations when given an overly plain version. Automatic adaptation risks serving the wrong level silently; manual controls require the actor to choose before reading.
  • Editorial accountability vs. maintenance: authored variants are reviewed by someone accountable for what they omit, but go stale when the source text changes. Generated variants stay in sync with the source, but have no human editor standing behind them.
  • How audiences differ: a lens can only reorganise or rephrase information that is already in the source text. Readers differ in three ways:
    • Background knowledge and fluency: the facts stay the same while vocabulary, sentence complexity, or language changes. This is suited to generation from the source.
    • Task or purpose: executing a step, troubleshooting, or evaluating. The underlying facts stay the same, but priority and omissions shift.
    • Applicable rules or context: permissions, pricing tier, platform, or jurisdiction. These require facts outside the passage; generating them invites fabrication, so they belong in authored conditional content instead.

Solution

Let the actor switch the level of detail or reading framing of a document—by passage or as a whole—generating the view strictly from the source text while keeping the original one step away. Use authored content, not generation, for variations that depend on external rules such as permissions, pricing tier, platform, or region.

Where the source is a text of record, such as a contract, policy, or clinical instruction, present the generated view as a reading aid that links back to the binding text rather than replacing it.

Continuation

The actor reads an adapted view while the source text remains unchanged. Each adapted view is generated content derived from the original. Anchor claims in a shortened view to their source passages with citation, so the summary leads back into the document rather than replacing it. Mark the adapted view with provenance marking where the actor needs to distinguish the author's wording from generated text. When a text lens reorders and prunes a document around the actor's task, it works like a purpose-keyed view on a single text and shares its trade-off: whatever is omitted, the actor must know to look for…

All connections
Enables
Semantic zoom — A text lens helps complete help, where the same documentation serves actors with very different background knowledge, and supplies the coarser text levels that semantic zoom and focus and context step through when operating on prose.
Complements
Generated content — an adapted version produced from the source text is generated content
Provenance marking — Mark the adapted view with provenance marking where the actor needs to distinguish the author's wording from generated text.
Related to
Citation — Anchor claims in a shortened view to their source passages with citation, so the summary leads back into the document rather than replacing it.
Instructed revision — A text lens is not progressive disclosure, which reveals detail the author already wrote, nor instructed revision, which edits the shared document itself
Progressive disclosure — progressive disclosure reveals detail the author wrote in advance; a text lens generates levels on demand
Localization — translating content on request is a text lens; adapting the interface's own copy to a locale is localization
Purpose-keyed view — a purpose-based text lens reorders and prunes one document the way a purpose-keyed view shapes a collection
Appears in
Making sense at scale: Choosing how to show the collection, step 1

In practice

Adjusting detail by passage

Adapting for the audience

Research on this pattern

Resources & references