Asking for a Change to a Supervisor Proposal
Reviewing a supervisor proposal — a suggested fix or a drafted knowledge-base article — used to mean editing the text by hand if it wasn’t quite right. The Improve this draft box lets you skip that: type what you want changed in your own words, click Revise, and the proposal is rewritten in place. You never leave the card.
Where the box appears
The Improve this draft box sits on a supervisor review card, under the proposed content, with the prompt “Describe the change in your own words — we rewrite the draft.” It appears only on a proposal that is still pending, and only for the four kinds it can rewrite: a knowledge-base article draft, a handbook article draft, an instructions edit, and a routing update.
Instead of clicking into the body and editing it yourself, type an instruction describing the change you want, for example “make this shorter” or “escalate billing questions to the team instead of the knowledge base.” The box takes up to 2000 characters; ⌘/Ctrl + Enter submits it without reaching for the button.
What happens while it’s rewriting
Clicking Revise kicks off a rewrite of the proposal’s content based on your instruction. While that’s in progress:
- The card stays where it is — a card is pinned in place across the refresh that lands the result, so you read it where you left off instead of hunting for it. A line on the card says “Revising the draft — the card stays here.”
- The card’s commit button (Apply fix, Publish article, Change instructions — it is labelled for what it does) and Edit are disabled, so you can’t apply a version that’s about to be replaced, or start manually editing a body the rewrite is still working on.
Rewrites take a while — the button itself says “Revising — takes ~30s” — so it’s normal for the card to sit in this state for a stretch. When it lands, the card says “The draft was revised. Check it, then apply.”
Reading the result
What you see next depends on which kind of proposal you revised.
A fix — an instructions edit or a routing update — comes back as a single marked-up body of text comparing the proposal against the wording that is live today:
- Added text is highlighted to show it’s new.
- Removed text is struck through to show it’s going away.
The caption under it says so: applying keeps the added text and drops the struck-through text. Note that this marking compares the proposal with today’s live value, not with the previous version of the proposal — so it’s there whether or not you revised anything, and a revision changes what is marked rather than turning the marking on.
An article draft is not marked up. The revised body simply renders as the article, under The drafted article (or The updated article when it revises an existing one). If it revises an existing article or handbook entry, the card also warns about lines dropped from the current version and offers a What it says today disclosure so you can compare by eye. Read the whole body before applying — there is no inline diff to lean on.
When it’s not available
The Improve this draft box is hidden in two situations:
- Demo mode. It doesn’t render on the one-at-a-time review cards or the finding pane while the tenant is in demo mode.
- After you’ve started editing manually. On the finding pane and the quick-draft pane, opening the proposal for manual editing removes the box — a revision rewrites the original body on the server, which would discard the edits you’ve already started typing.
If you want to revise after starting a manual edit, discard your in-progress edit first, then use the box as normal.