**Revise** is how you write and improve compliance documents with the AI in the loop. You give it a goal — "Draft an access control policy for our cloud setup", "Add a section on incident response to this procedure" — and it produces the work as a set of **staged changes** grounded in your project's context and evidence. Nothing is written to your document library until you approve it, so the AI can do the heavy lifting while you keep the final say.

## Starting a revision

A revision can begin in a couple of places:

- From the **Revisions** area under Documentation, where your recent revisions are also listed.
- From the **Act** stage of a [gap analysis](/guides/running-a-gap-analysis/), where **Start a revision** has an agent act on the findings — drafting a management report, a regulatory plan, or documentation that closes a gap.

A revision can **create new documents** or **modify existing ones**, and a single revision can do both at once.

**Manage:** [Revisions](https://app.regnora.com/documentation/revise)

## Reviewing staged changes

A revision opens in a two-panel view. On one side is the list of entries the AI has staged — each new document or each change to an existing one. On the other is the focused view of the entry you've selected, showing the proposed content (and, for an edit, the difference from the current version).

You decide entry by entry what to keep. When you're happy, **Apply** the revision to write the approved changes into your document library; **Discard** throws the staged changes away without touching anything. Because every change passes through this review, an agent can never alter your evidence silently — applying is always a deliberate human step.

## How drafts stay grounded

Revise doesn't write in a vacuum. It draws on your [project profile](/guides/project-profile-and-context/) and the [documents](/guides/managing-documents/) already in the project, so a drafted policy reflects your organisation's actual context and references the evidence you hold rather than generic boilerplate. The better your profile and evidence, the closer the first draft lands.