# Revising a Page



<a id="section-goal"></a>

Revision changes a page without producing it again. It starts from the current text, changes only what your instruction and the sources support, and sends the result back through Review. The page keeps its identity and URL, which makes revision the right tool for wording, structure and factual fixes.


<a id="section-which"></a>

## Two situations

| The page is | How to ask | What happens |
| --- | --- | --- |
| A candidate in the current Review | Write a note in the report, or say it in the conversation | The Agent repairs it within the same batch and shows an updated report |
| Already approved | *"Revise `<page>`: `<problem>`, keep the source citations"* | The Agent runs `context revise <page> --instruction "<text>"`; the new version enters Review |

For an approved page outside the active batch, the revision is queued and runs after the batch by default; `--timing priority` asks for earlier delivery but never skips Review. Several approved pages can be revised together with `context task maintain`.


<a id="section-how"></a>

## What the Agent does

- Reads the whole page first and keeps explanations that are still correct, including your earlier contributions.
- For a wording-only change, uses the approved text alone; it does not recapture or re-parse the source.
- For a changed fact, reads the relevant registered material. A new fact that only exists in your instruction is first saved as a source, such as a [note](</context/llms/pages/90474554e682f858092546bb5cea1e31.txt>).
- Edits one section or the whole page. Section edits leave other sections and their citations untouched; a citation change replaces that section's references, which Context re-fingerprints.

Before submitting, the Agent can preview the assembled page and the previous text without accepting the edit.


<a id="section-move"></a>

## Moving or renaming a page

`context revise <page> --move-to <new-path>` revises and moves in one step. The page keeps its article identity and section IDs, its relative links are rebased to the new location, and approval updates incoming Markdown links together — no second copy and no manual deletion. To change only the title or menu position, adjust the knowledge map instead; see [Reorganizing at Scale](</context/llms/pages/9b7018d3ff025bc9a5ed714bf0a7762c.txt>).


<a id="section-generated"></a>

## Generated reference pages

Pages with generated API tables are regenerated, not hand-edited: `--regenerate` rebuilds their program blocks from the current source even when the version has not changed. If the same wrong value survives regeneration, the Agent reports the page, field and source comparison instead of repeating the repair.


<a id="section-source-wrong"></a>

## When the source is wrong

If the page faithfully reflects a source that is itself wrong, correct the source — recapture it, or correct the note or session summary — and then update the page. If the source is right and the page misleads, revise only the page.

---

## Sources

- [context/packages/context-cli/context-workflow/resources/procedures/approved-revision.md L9–L11 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/approved-revision.md#L9-L11>)
- [context/packages/context-cli/context-workflow/resources/procedures/approved-revision.md L40–L44 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/approved-revision.md#L40-L44>)
- [context/packages/context-cli/README.md L345–L357 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L345-L357>)
- [context/packages/context-cli/context-workflow/resources/procedures/knowledge-review.md L98–L104 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/knowledge-review.md#L98-L104>)
- [context/packages/context-cli/context-workflow/resources/procedures/approved-revision.md L9–L18 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/approved-revision.md#L9-L18>)
- [context/packages/context/docs/guides/knowledge-updates.md L323–L343 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/knowledge-updates.md#L323-L343>)
- [context/packages/context-cli/context-workflow/resources/procedures/approved-revision.md L60–L66 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/approved-revision.md#L60-L66>)
- [context/packages/context-cli/README.md L325–L327 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L325-L327>)
- [context/packages/context-cli/README.md L347–L349 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/README.md#L347-L349>)
- [context/packages/context-cli/context-workflow/resources/procedures/knowledge-review.md L106–L115 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context-cli/context-workflow/resources/procedures/knowledge-review.md#L106-L115>)
- [context/packages/context/docs/guides/note.md L32–L35 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/guides/note.md#L32-L35>)
- [context/packages/context/docs/getting-started.md L161–L166 · 3b0ce0a](<https://github.com/context4ai/context/blob/3b0ce0a0a1761f5fceb3bb48fb9dc29b54c0786b/packages/context/docs/getting-started.md#L161-L166>)