Use AI to improve an article
The Improve action rewrites for clarity and flow. Sentences may be reordered, paragraphs may be split, weak phrasing may be replaced. The article keeps its facts and scope; the writing gets better.
This is the right action when an article reads stiff, technical, or list-heavy in a way that hurts comprehension — but the underlying content is correct.
1. Open the article
Go to Knowledge Base. Click the article in the middle pane to load it in the editor.
2. Highlight what you want improved
Highlight the section you want rewritten. Improve is more aggressive than Clean Up, so running it on the whole body at once produces broader changes that can be harder to review.
A common pattern: one paragraph at a time. Improve the lead, scan the diff, accept or roll back, move on.
3. Open the AI Writing Assistant
Click the Sparkles icon below the editor body. The AI Writing Assistant popover appears.
4. Click Improve
The button is next to Clean Up. Click it once. The selection is rewritten in place.
5. Review carefully
Improve makes substantive changes to wording. Read the rewritten section closely:
- Facts: Did the AI accidentally drop a detail, or insert a claim that isn’t supported by the original? Improve isn’t supposed to add or remove information, but it sometimes paraphrases in a way that subtly shifts meaning.
- Voice: Does the rewrite still sound like your house style? If it’s gone formal where you wanted casual (or vice versa), that’s a sign you should use the free-form prompt input instead with an explicit tone direction.
- Specifics: Did the AI replace concrete instructions with vague summaries? “Click Settings → Knowledge → Languages” should not become “navigate to the languages settings.”
If any of those feel off, undo (Ctrl/Cmd+Z) and either rewrite manually or try the prompt input with a clearer ask.
6. Save
Saves automatically.
Improve vs. Clean Up — when to pick which
- The article is well-written but has typos — The article reads stiff or list-heavy
- You want a fast proofread — You want the writing to flow better
- You want minimal change — You’re OK with sentence-level rewrites
- You’re about to publish — You’re polishing a near-final draft
You can run them sequentially: Improve the draft for flow, then Clean Up the result for typos.
Improve vs. the prompt input
Improve uses a fixed instruction (“rewrite for clarity and flow”). If you want a specific change — make this more casual, cut this to half the length, rewrite for a developer audience — use the free-form prompt input (Ask AI to write or edit content) instead. It accepts any natural-language instruction.
Common gotchas
- Improve is not “make this longer.” It will sometimes shorten content if it judges the original to be wordy. If you want depth, use the prompt input with an explicit instruction.
- Improve can lose lists. Bulleted reference lists sometimes get prose-ified. If your article relies on a scannable list, run Improve on the surrounding prose only and leave the list alone.
- Code blocks survive cleanup but not always improvement. If the article has fenced code samples, check that they survived the rewrite intact.