You can review the suggestions Ellie proposes for your documentation and decide whether to accept or dismiss them. Suggestions appear in two places:
- on the project Overview in the Since your last push card
- in Chat as suggestion cards
Step 1: Open the suggestion
Open the suggestion from either place:
- the Since your last push card on Overview, or
- a suggestion card in Chat

Step 2: Check the latest run on Overview
In the Since your last push card, Ellie shows the latest run under the heading. This can include the note, time, commit range, and how many articles were checked.
You may also see one of these states:
- Checking your docs against the latest push…
- Run failed: <error>
- No pushes checked yet. Ellie reviews your docs after every push to the repo — or check now.
To ask Ellie to check again, select Check latest push. While the check is running, the button shows Checking…. Results take a few minutes.
Step 3: Check what kind of suggestion it is
Each open suggestion appears as a row with a kind, the article title, a short reason, and actions.
A suggestion can be one of these kinds:
- Article update
- New article
- Archive
- Screenshot refresh
- API drift
In Chat, the same suggestions appear as cards with the chips Edit, Archive, or New article.
Step 4: Review the suggestion
Open the suggestion before you decide.
For an Article update, Review opens Suggested update to “<title>”. The dialog shows Why: … and a toggle labelled Show the N outdated claim(s) Ellie found. Below that, the diff shows added lines in green, removed lines in red and struck through, and ⋯ N unchanged lines ⋯ for the rest.
For a New article, the dialog is New article: <title> and shows the proposed text.
For an Archive, the dialog is Archive “<title>”?.
For a Screenshot refresh, the dialog is Screenshot refresh in “<title>”. If a replacement has already been captured, the dialog shows Current and Proposed replacement side by side.
For API drift, there is no Review button. It is informational only.
The review dialog shows Open article on the left, then Dismiss and Accept.
Step 5: Accept the suggestion
If the suggestion is correct, choose Accept.
What happens next depends on the suggestion type:
- Article update replaces the article text immediately and records a revision. If the article is published, the live page updates straight away.
- New article creates the article as an unpublished draft in the suggested collection. Accepting never publishes it. In Chat, the card then says Saved as a draft article with an Open button.
- Archive archives the article. It comes off the public help centre immediately. Its history is kept and it can be restored from the editor.
- Screenshot refresh replaces the current screenshot with the proposed one, or starts a fresh capture if one has not been captured yet.
- API drift only acknowledges the suggestion. It does not change your docs or spec.
Accepting on Overview or in Chat is the same action.
Step 6: Dismiss the suggestion
If the suggestion is not right, choose Dismiss.
Ellie then opens Dismiss this suggestion? with an optional box labelled Why is it wrong? (optional — helps Ellie learn). If you add a reason, Ellie keeps it and shows it to the checker as an example of what you rejected.
Step 7: Re-check if the suggestion is out of date
If the article changed after the suggestion was drafted, Accept fails with this message:
The article changed since this suggestion was drafted — re-check it against the latest code before accepting.
The button then changes to an amber Re-check now and shows Re-checking… while Ellie recomputes the suggestion.
A fresh suggestion replaces the old one if a change is still needed. If no change is needed any more, the suggestion disappears.
A newer push can also replace an open suggestion with an updated one. If a later push reverts the underlying change, the suggestion is withdrawn.
Good to know
- Suggestions are reviewable changes, not automatic edits. Your docs only change after you accept a suggestion.
- If you want to inspect how an article changed over time after accepting an update, open the article and click History (N) in the editor header; see Write and edit an article.