From 98cc64708c5d59f59e7996d17820c0313c6a4fa1 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 10 Feb 2026 21:30:56 +0000 Subject: [PATCH 1/2] Update editor/index.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- editor/index.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/editor/index.mdx b/editor/index.mdx index 251c69058..a43cfc997 100644 --- a/editor/index.mdx +++ b/editor/index.mdx @@ -29,6 +29,7 @@ Create, edit, and publish documentation directly in your browser with the web ed - **Git synchronization**: All changes sync automatically with your documentation repository. - **Branch workflows**: Work on feature branches and create pull requests for review. - **Team collaboration**: Multiple team members can work simultaneously with preview deployments. +- **Comments**: Add comments to text, reply to threads, and resolve discussions directly in the editor. ## Get started From 2dc8cf2e885744b555d2e9335535746de74f40c6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 10 Feb 2026 21:31:19 +0000 Subject: [PATCH 2/2] Update editor/collaborate.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- editor/collaborate.mdx | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx index eafeee267..4e8c25d35 100644 --- a/editor/collaborate.mdx +++ b/editor/collaborate.mdx @@ -61,6 +61,45 @@ Share the preview deployment URL with team members to gather feedback. Previews Preview URLs are publicly accessible by default. Enable preview authentication in the [Add-ons](https://dashboard.mintlify.com/products/addons) page of your dashboard to restrict access to authenticated organization members. +## Comments + +Add comments to documentation text to discuss changes, ask questions, or provide feedback. Comments help teams collaborate on content without modifying the actual documentation. + +### Add a comment + +1. Select the text you want to comment on in the editor. +2. Click the comment icon (speech bubble) in the floating toolbar that appears. +3. Type your comment in the input field. +4. Click **Send comment** or press **Enter** to post the comment. + +The commented text is highlighted in the editor, and a gutter icon appears next to the line showing the number of comment threads. + +### View comments + +All comments for the current page appear in the comments sidebar on the right side of the editor. The sidebar shows: + +- Comment threads grouped by date (Today, Yesterday, or the specific date) +- The quoted text each comment refers to +- All replies in each thread +- The author and timestamp for each comment + +Click the comment badge in the top toolbar to open or close the comments sidebar. The badge shows the number of unresolved comments on the current page. + +### Reply to comments + +1. Open the comments sidebar or click a comment gutter icon. +2. Type your reply in the **Reply...** input field at the bottom of the thread. +3. Click **Send comment** or press **Enter** to post your reply. + +### Resolve or delete comments + +- **Resolve**: Click the checkmark icon on a comment thread to mark it as resolved. Resolved threads are removed from the sidebar. +- **Delete**: Click the trash icon on a comment to delete it. Deleting the first comment in a thread deletes the entire thread. + + + Comments are saved to your documentation repository and persist across branches. When you switch branches, you'll see comments specific to that branch. + + ## Share editor links Share a direct link to a specific page in the editor with your teammates. Use editor links to collaborate on updates and make changes to pages.