Pathway card
The answer function compiles — it doesn’t read
Is an AI answer function a reader of the documentation?
A pathway card shows where a practice starts, where it can get to, what does not change on the way, and the steps from one to the other. The path from before to after
The short answer
No. It reads and writes in one act: it selects released units and composes a new text from them that nobody released. That makes it a compiler, like an assembled manual or a translation. Treated as a reader, its answer is taken for the documentation; treated as a compiler, it has to say what it was compiled from and what it may never change.
For: Technical writers, technical project managers and documentation systems developers
Key points
- An answer is not a reading.
- The answer function selects, combines and rewords — three acts of compiling.
- A compiled text names its released sources and their validity.
- Safety information may not be shortened by any compiling role.
- Reader and user are not the same word.
Before and after
Before
The answer function as a reader
- The function “reads the manual” for the user.
- Its answer is treated like the released text.
- What it may change is not written down.
After
The answer function as a compiler
- The function selects, combines and rewords — and says so.
- Every answer names the released units and their validity.
- What it may change is written down; safety information never.
Side by side
Each row names how far the control is as of the review date.
| Aspect | Before | After | Maturity |
|---|---|---|---|
| Name of the role | Reader | Compiler | Building block available A naming decision |
| Sources of an answer | Invisible | Named with their validity | Product-specific Answer provenance in some tools |
| What may change | Not written down | Order and wording; scope by rule; safety information never | Building block available Configuration of the function |
| Correction | In the answer only | In the source, then in every answer | Building block available Feedback loop to the source |
The path from before to after
Each step names who does it and what it leaves as evidence.
Rename the role
Describe the answer function as a compiling role in the documentation plan.- Who
- Technical project manager
- Evidence
- Role description
Release its sources
Release the units the function may use, with their validity.- Who
- Documentation owner
- Evidence
- Release record of the configuration
Write its limits
Write down what the function may change and what it must show in full.- Who
- Technical writer with the system developers
- Evidence
- Rules of the function
Show the sources
Make every answer name the released units it was compiled from.- Who
- Documentation systems developers
- Evidence
- Answer provenance
Limits and residual risk
Naming the function a compiler doesn’t make its answers correct. Showing sources depends on the tool and is not settled for every kind of answer.
The context
The simplification
The blueprint “The content lifecycle under AI” uses “the reader” and “the user” interchangeably and places the answer function in the stage “Answer”, where the user receives a text that nobody released. The blueprint already says it — but calls the function a reader elsewhere.
Where it becomes too coarse
A retrieval-augmented answer function does three things: it selects units, it combines them and it rewords them. Each is compiling. The result is a new text, like an assembled manual or a translation made with a translation memory. If it is called a reader, its answer is treated as if it were the documentation.
The role grammar
The family compiling holds passing on, deriving, assembling, packaging, translating and answering. Each compiling role says what it was compiled from — answer provenance and grounding are the established ways for answers — and what it may change: order, wording, scope — never the safety information.
Questions readers ask next
- Does that make AI answers less trustworthy?
- No. It makes them checkable: an answer that names its released sources and their validity can be compared with them.
- Is the answer function then a writer?
- It writes a new text, but it doesn’t create knowledge. The role grammar files it under compiling: it makes something new from what was released.
Review log and changes
Every context card is checked against its sources before it is published, and again whenever it changes; the date under the byline is the last review. Corrections (something was wrong) and additions (something was missing) are logged below with date and time (Berlin time). Typos, formatting and link fixes are not listed.
Reviewed
No corrections or additions since publication.