mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
ade1fbbd39
* docs: address reader-question gaps in recently updated pages * docs: shorten analytics description, split long sentence, mirror translations --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
51 lines
2.3 KiB
Plaintext
51 lines
2.3 KiB
Plaintext
---
|
|
title: "Suggest changes in the editor"
|
|
sidebarTitle: "Suggestions"
|
|
description: "Propose text changes as suggestions that teammates can review, accept, or reject in the editor without modifying the current page content."
|
|
keywords: ["suggestions", "suggesting", "collaboration", "review"]
|
|
---
|
|
|
|
Suggestions let you propose changes to text while preserving the current content. Teammates can review, accept, or reject your suggestions.
|
|
|
|
Suggesting mode applies to page text. Editors and admins can accept or reject any suggestion; viewers cannot. See [roles](/dashboard/roles) for details.
|
|
|
|
Pending suggestions appear as highlighted text in the editor and are listed in the sidebar alongside comments so reviewers can find them.
|
|
|
|
## Make suggestions
|
|
|
|
1. Highlight any text on the page.
|
|
2. Click the <Icon icon="pen" /> **Switch to Suggesting** button in the toolbar.
|
|
3. In suggesting mode, edit any text. Deletions and insertions appear with highlighting so that reviewers can identify the changes you propose.
|
|
4. To exit suggesting mode, click the <Icon icon="pen" /> **Switch to Editing** button.
|
|
|
|
<Note>
|
|
[Viewers](/dashboard/roles) are always in suggesting mode. Suggesting mode activates automatically when a viewer opens the editor and viewers cannot turn off suggesting mode. This lets viewers propose changes without directly editing content.
|
|
</Note>
|
|
|
|
<Frame>
|
|
<img
|
|
src="/images/editor/suggesting-light.png"
|
|
alt="The switch to suggesting button in the floating toolbar above selected text in the editor."
|
|
className="block dark:hidden"
|
|
/>
|
|
<img
|
|
src="/images/editor/suggesting-dark.png"
|
|
alt="The switch to suggesting button in the floating toolbar above selected text in the editor."
|
|
className="hidden dark:block"
|
|
/>
|
|
</Frame>
|
|
|
|
## Accept a suggestion
|
|
|
|
1. Click the highlighted suggestion text.
|
|
2. Click the <Icon icon="check" /> **Accept** button to apply the suggested change.
|
|
|
|
Accepting a suggestion resolves and deletes the suggestion thread. The accepted change becomes part of the current draft and goes live the next time you [publish](/editor/branching-and-publishing).
|
|
|
|
## Reject a suggestion
|
|
|
|
1. Click highlighted suggestion text.
|
|
2. Click the <Icon icon="trash-2" /> **Reject** button to discard the proposed change.
|
|
|
|
Rejecting a suggestion resolves and deletes the suggestion thread.
|