mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
f8e015ff62
* Improve SEO metadata: update descriptions to 130-155 chars across 177 pages Generated-By: mintlify-agent * Apply suggestion from @ethanpalm * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * 💅 --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
56 lines
2.4 KiB
Plaintext
56 lines
2.4 KiB
Plaintext
---
|
|
title: "Suggestions"
|
|
description: "Propose text changes as suggestions that teammates can review, accept, or reject in the web editor without directly modifying the original page."
|
|
keywords: ["suggestions", "suggesting", "collaboration", "review"]
|
|
---
|
|
|
|
Suggestions let you propose changes to text without modifying the existing content. Teammates can review, accept, or reject your suggestions.
|
|
|
|
If your branch has an open pull request on GitHub, Mintlify adds a summary of open suggestions to the pull request description. The summary lists the files with suggestions, a preview of each suggested change, and a link to open that file in the editor.
|
|
|
|
The summary updates automatically when you add, accept, or reject a suggestion.
|
|
|
|
## Enable suggesting mode
|
|
|
|
1. Highlight any text on the page.
|
|
2. Click the **Switch to Suggesting** button, the pen icon, in the toolbar that appears.
|
|
|
|
While suggesting mode is active, the **Suggesting** indicator appears in the editor toolbar.
|
|
|
|
To exit suggesting mode, click the **Suggesting** indicator.
|
|
|
|
<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 web editor. The Suggesting indicator is visible in the top toolbar."
|
|
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 web editor. The Suggesting indicator is visible in the top toolbar."
|
|
className="hidden dark:block"
|
|
/>
|
|
</Frame>
|
|
|
|
## Make a suggestion
|
|
|
|
With suggesting mode enabled, edit any text. Any deletions or insertions appear with distinct highlighting so that reviewers can see what changes you propose.
|
|
|
|
## Accept a suggestion
|
|
|
|
1. Click highlighted suggestion text.
|
|
2. Click the accept button, the checkmark icon, to apply the suggested change.
|
|
|
|
Accepting a suggestion saves the updated text and resolves the suggestion thread.
|
|
|
|
## Reject a suggestion
|
|
|
|
1. Click highlighted suggestion text.
|
|
2. Click the reject button, the trashcan icon, to discard the proposed change.
|
|
|
|
Rejecting a suggestion preserves the original text and resolves the suggestion thread.
|