From d250c918150ecfca52f70f2e502fea6c30f6842d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 20:34:00 +0000 Subject: [PATCH 1/4] docs: document editor suggesting mode --- editor/suggestions.mdx | 8 +++++--- es/editor/suggestions.mdx | 6 ++++-- fr/editor/suggestions.mdx | 6 ++++-- zh/editor/suggestions.mdx | 6 ++++-- 4 files changed, 17 insertions(+), 9 deletions(-) diff --git a/editor/suggestions.mdx b/editor/suggestions.mdx index 765e6c4f29..8e55861782 100644 --- a/editor/suggestions.mdx +++ b/editor/suggestions.mdx @@ -1,5 +1,5 @@ --- -title: "Suggest changes in the editor" +title: "Suggest text changes in the Mintlify content 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"] @@ -11,15 +11,17 @@ Suggesting mode applies to page text. Editors and admins can accept or reject an Pending suggestions appear as highlighted text in the editor. The sidebar lists them alongside comments so reviewers can find them. +When suggesting mode is active, the editor displays a **Suggesting** pill in the top bar. Use it to confirm that your edits will be saved as suggestions. + ## Make suggestions 1. Highlight any text on the page. 2. Click the **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 **Switch to Editing** button. +4. To exit suggesting mode, click the **Switch to Editing** button in the floating toolbar or the **X** on the **Suggesting** pill in the top bar. - [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. + [Viewers](/dashboard/roles) are always in suggesting mode. Suggesting mode activates automatically when a viewer opens the editor. The **Suggesting** pill is visible but not interactive for viewers, so they remain in suggesting mode. This lets viewers propose changes without directly editing content. diff --git a/es/editor/suggestions.mdx b/es/editor/suggestions.mdx index db19a96a59..e5bb03e27c 100644 --- a/es/editor/suggestions.mdx +++ b/es/editor/suggestions.mdx @@ -10,6 +10,8 @@ El modo de sugerencia se aplica al texto de la página. Los editors y admins pue Las sugerencias pendientes aparecen como texto resaltado en el editor y se muestran en la barra lateral junto a los comentarios para que los revisores puedan encontrarlas. +Cuando el modo de sugerencias está activo, el editor muestra un indicador **Suggesting** en la barra superior. Úsalo para confirmar que tus ediciones se guardarán como sugerencias. +
## Hacer sugerencias
@@ -17,10 +19,10 @@ Las sugerencias pendientes aparecen como texto resaltado en el editor y se muest 1. Resalta cualquier texto de la página. 2. Haz clic en el botón **Switch to Suggesting** en la barra de herramientas. 3. En el modo de sugerencias, edita el texto. Las eliminaciones e inserciones aparecen resaltadas para que los revisores puedan identificar los cambios que propones. -4. Para salir del modo de sugerencias, haz clic en el botón **Switch to Editing**. +4. Para salir del modo de sugerencias, haz clic en el botón **Switch to Editing** de la barra flotante o en la **X** del indicador **Suggesting** de la barra superior. - Los [viewers](/es/dashboard/roles) siempre están en modo de sugerencias. El modo de sugerencias se activa automáticamente cuando un viewer abre el editor y los viewers no pueden desactivarlo. Esto les permite proponer cambios sin editar directamente el contenido. + Los [viewers](/es/dashboard/roles) siempre están en modo de sugerencias. El modo de sugerencias se activa automáticamente cuando un viewer abre el editor. El indicador **Suggesting** es visible, pero no interactivo para los viewers, por lo que permanecen en modo de sugerencias. Esto les permite proponer cambios sin editar directamente el contenido. diff --git a/fr/editor/suggestions.mdx b/fr/editor/suggestions.mdx index 4fe880cbbd..c3532c156e 100644 --- a/fr/editor/suggestions.mdx +++ b/fr/editor/suggestions.mdx @@ -10,6 +10,8 @@ Le mode de suggestion s'applique au texte de la page. Les editors et admins peuv Les suggestions en attente apparaissent sous forme de texte surligné dans l'éditeur et sont listées dans la barre latérale à côté des commentaires afin que les relecteurs puissent les retrouver. +Lorsque le mode suggestion est actif, l'éditeur affiche une pastille **Suggesting** dans la barre supérieure. Utilisez-la pour vérifier que vos modifications seront enregistrées comme suggestions. +
## Faire des suggestions
@@ -17,10 +19,10 @@ Les suggestions en attente apparaissent sous forme de texte surligné dans l'éd 1. Surlignez n'importe quel texte de la page. 2. Cliquez sur le bouton **Switch to Suggesting** dans la barre d'outils. 3. En mode suggestion, modifiez le texte. Les suppressions et les insertions apparaissent surlignées afin que les relecteurs puissent identifier les changements que vous proposez. -4. Pour quitter le mode suggestion, cliquez sur le bouton **Switch to Editing**. +4. Pour quitter le mode suggestion, cliquez sur le bouton **Switch to Editing** de la barre d'outils flottante ou sur le **X** de la pastille **Suggesting** dans la barre supérieure. - Les [viewers](/fr/dashboard/roles) sont toujours en mode suggestion. Le mode suggestion s'active automatiquement lorsqu'un viewer ouvre l'éditeur et les viewers ne peuvent pas le désactiver. Cela leur permet de proposer des modifications sans éditer directement le contenu. + Les [viewers](/fr/dashboard/roles) sont toujours en mode suggestion. Le mode suggestion s'active automatiquement lorsqu'un viewer ouvre l'éditeur. La pastille **Suggesting** est visible, mais elle n'est pas interactive pour les viewers, qui restent donc en mode suggestion. Cela leur permet de proposer des modifications sans éditer directement le contenu. diff --git a/zh/editor/suggestions.mdx b/zh/editor/suggestions.mdx index 02c8b3b6c9..d3d694bb50 100644 --- a/zh/editor/suggestions.mdx +++ b/zh/editor/suggestions.mdx @@ -10,6 +10,8 @@ keywords: ["建议", "提议", "协作", "审阅"] 待处理的建议会在编辑器中以高亮文本显示，并与评论一起列在侧边栏中，方便审阅者查找。 +启用建议模式后，编辑器顶部栏会显示 **Suggesting** 指示器。你可以通过该指示器确认编辑内容会作为建议保存。 +
## 提出建议
@@ -17,10 +19,10 @@ keywords: ["建议", "提议", "协作", "审阅"] 1. 选中页面上的任意文本。 2. 在工具栏中点击 **Switch to Suggesting** 按钮。 3. 在建议模式下编辑任何文本。删除和新增内容会以高亮显示，以便审阅者识别你提出的更改。 -4. 要退出建议模式，请点击 **Switch to Editing** 按钮。 +4. 要退出建议模式，请点击悬浮工具栏中的 **Switch to Editing** 按钮，或点击顶部栏 **Suggesting** 指示器上的 **×**。 - [Viewers](/zh/dashboard/roles) 始终处于建议模式。当 viewer 打开编辑器时，建议模式会自动启用，且 viewer 无法关闭建议模式。这样一来，viewer 可以在不直接编辑内容的情况下提出更改建议。 + [Viewers](/zh/dashboard/roles) 始终处于建议模式。当 viewer 打开编辑器时，建议模式会自动启用。顶部栏中的 **Suggesting** 指示器对 viewer 不可交互，因此 viewer 无法退出建议模式。这样一来，viewer 可以在不直接编辑内容的情况下提出更改建议。 From 71c9a91b4d7a9ea845e51d0b2b67b4ce8b113944 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 20:38:26 +0000 Subject: [PATCH 2/4] docs: polish suggesting mode translations --- editor/suggestions.mdx | 2 +- es/editor/suggestions.mdx | 4 ++-- fr/editor/suggestions.mdx | 4 ++-- zh/editor/suggestions.mdx | 10 +++++----- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/editor/suggestions.mdx b/editor/suggestions.mdx index 8e55861782..6e1698ddbe 100644 --- a/editor/suggestions.mdx +++ b/editor/suggestions.mdx @@ -11,7 +11,7 @@ Suggesting mode applies to page text. Editors and admins can accept or reject an Pending suggestions appear as highlighted text in the editor. The sidebar lists them alongside comments so reviewers can find them. -When suggesting mode is active, the editor displays a **Suggesting** pill in the top bar. Use it to confirm that your edits will be saved as suggestions. +When suggesting mode is active, the editor displays a **Suggesting** pill in the top bar. The pill confirms that your edits will be saved as suggestions. ## Make suggestions diff --git a/es/editor/suggestions.mdx b/es/editor/suggestions.mdx index e5bb03e27c..dd532d06a7 100644 --- a/es/editor/suggestions.mdx +++ b/es/editor/suggestions.mdx @@ -1,5 +1,5 @@ --- -title: "Sugerencias" +title: "Guía para sugerir cambios de texto en el editor de Mintlify" description: "Propón cambios de texto como sugerencias que tus compañeros pueden revisar, aceptar o rechazar en el editor sin modificar el contenido actual." keywords: ["sugerencias", "sugerir", "colaboración", "revisión"] --- @@ -10,7 +10,7 @@ El modo de sugerencia se aplica al texto de la página. Los editors y admins pue Las sugerencias pendientes aparecen como texto resaltado en el editor y se muestran en la barra lateral junto a los comentarios para que los revisores puedan encontrarlas. -Cuando el modo de sugerencias está activo, el editor muestra un indicador **Suggesting** en la barra superior. Úsalo para confirmar que tus ediciones se guardarán como sugerencias. +Cuando el modo de sugerencias está activo, el editor muestra un indicador **Suggesting** en la barra superior. El indicador confirma que tus ediciones se guardarán como sugerencias.
## Hacer sugerencias diff --git a/fr/editor/suggestions.mdx b/fr/editor/suggestions.mdx index c3532c156e..6c73a7604a 100644 --- a/fr/editor/suggestions.mdx +++ b/fr/editor/suggestions.mdx @@ -1,5 +1,5 @@ --- -title: "Suggestions" +title: "Guide des suggestions de texte dans l’éditeur Mintlify" description: "Proposez des modifications de texte comme suggestions que vos coéquipiers peuvent examiner, accepter ou rejeter dans l'éditeur, sans altérer le contenu actuel." keywords: ["suggestions", "suggérer", "collaboration", "révision"] --- @@ -10,7 +10,7 @@ Le mode de suggestion s'applique au texte de la page. Les editors et admins peuv Les suggestions en attente apparaissent sous forme de texte surligné dans l'éditeur et sont listées dans la barre latérale à côté des commentaires afin que les relecteurs puissent les retrouver. -Lorsque le mode suggestion est actif, l'éditeur affiche une pastille **Suggesting** dans la barre supérieure. Utilisez-la pour vérifier que vos modifications seront enregistrées comme suggestions. +Lorsque le mode suggestion est actif, l'éditeur affiche une pastille **Suggesting** dans la barre supérieure. Cette pastille confirme que vos modifications seront enregistrées comme suggestions.
## Faire des suggestions diff --git a/zh/editor/suggestions.mdx b/zh/editor/suggestions.mdx index d3d694bb50..b937c5e041 100644 --- a/zh/editor/suggestions.mdx +++ b/zh/editor/suggestions.mdx @@ -1,6 +1,6 @@ --- -title: "建议" -description: "将文本更改作为建议提出，团队成员可以在编辑器中审阅、接受或拒绝，而不会修改当前内容。" +title: "Mintlify 内容编辑器中的文本建议和协作审阅指南" +description: "了解如何在 Mintlify 内容编辑器中使用建议模式提出文本更改，查看高亮的待处理建议，并让团队成员审阅、接受或拒绝更改，同时保留当前页面内容不变。查看编辑者、管理员和查看者在建议模式中的权限，以及如何退出建议模式。适用于需要在发布前协作审阅文档内容的团队。" keywords: ["建议", "提议", "协作", "审阅"] --- @@ -10,7 +10,7 @@ keywords: ["建议", "提议", "协作", "审阅"] 待处理的建议会在编辑器中以高亮文本显示，并与评论一起列在侧边栏中，方便审阅者查找。 -启用建议模式后，编辑器顶部栏会显示 **Suggesting** 指示器。你可以通过该指示器确认编辑内容会作为建议保存。 +启用建议模式后，编辑器顶部栏会显示 **Suggesting** 指示器。该指示器表示编辑内容会作为建议保存。
## 提出建议 @@ -19,7 +19,7 @@ keywords: ["建议", "提议", "协作", "审阅"] 1. 选中页面上的任意文本。 2. 在工具栏中点击 **Switch to Suggesting** 按钮。 3. 在建议模式下编辑任何文本。删除和新增内容会以高亮显示，以便审阅者识别你提出的更改。 -4. 要退出建议模式，请点击悬浮工具栏中的 **Switch to Editing** 按钮，或点击顶部栏 **Suggesting** 指示器上的 **×**。 +4. 要退出建议模式，请点击悬浮工具栏中的 **Switch to Editing** 按钮，或点击顶部栏 **Suggesting** 指示器上的 **X**。 [Viewers](/zh/dashboard/roles) 始终处于建议模式。当 viewer 打开编辑器时，建议模式会自动启用。顶部栏中的 **Suggesting** 指示器对 viewer 不可交互，因此 viewer 无法退出建议模式。这样一来，viewer 可以在不直接编辑内容的情况下提出更改建议。 @@ -45,7 +45,7 @@ keywords: ["建议", "提议", "协作", "审阅"] 1. 点击高亮的建议文本。 2. 点击 **Accept** 按钮以应用建议的更改。 -接受建议会解决并删除该建议线程。 已接受的更改会成为你当前分支的一部分，并在你下次[发布](/zh/editor/branching-and-publishing)时上线。 +接受建议会解决并删除该建议线程。已接受的更改会成为你当前分支的一部分，并在你下次[发布](/zh/editor/branching-and-publishing)时上线。
## 拒绝建议 From ca0ae61ba6c6b7880f3b240355d8f2d0449db495 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 5 Aug 2026 15:30:44 -0700 Subject: [PATCH 3/4] Update editor/suggestions.mdx --- editor/suggestions.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/editor/suggestions.mdx b/editor/suggestions.mdx index 6e1698ddbe..2138f6e5ef 100644 --- a/editor/suggestions.mdx +++ b/editor/suggestions.mdx @@ -1,5 +1,5 @@ --- -title: "Suggest text changes in the Mintlify content editor" +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"] From 810a51a11e10f0ad4de3b7510a071905b178a67e Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 5 Aug 2026 15:30:49 -0700 Subject: [PATCH 4/4] Update editor/suggestions.mdx --- editor/suggestions.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/editor/suggestions.mdx b/editor/suggestions.mdx index 2138f6e5ef..cf23291f1a 100644 --- a/editor/suggestions.mdx +++ b/editor/suggestions.mdx @@ -11,8 +11,6 @@ Suggesting mode applies to page text. Editors and admins can accept or reject an Pending suggestions appear as highlighted text in the editor. The sidebar lists them alongside comments so reviewers can find them. -When suggesting mode is active, the editor displays a **Suggesting** pill in the top bar. The pill confirms that your edits will be saved as suggestions. - ## Make suggestions 1. Highlight any text on the page.