diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx index 3a5ec180a..eafeee267 100644 --- a/editor/collaborate.mdx +++ b/editor/collaborate.mdx @@ -1,8 +1,8 @@ --- title: "Collaborate in the web editor" sidebarTitle: "Collaborate" -description: "Work together on documentation with branches, pull requests, and preview deployments." -keywords: ["editor", "collaboration", "branches", "pull requests", "preview deployments"] +description: "Work together on documentation with branches, pull requests, preview deployments, and shareable editor links." +keywords: ["editor", "collaboration", "branches", "pull requests", "preview deployments", "share links"] --- Collaborate with your team on documentation using branch-based workflows, pull requests, and preview deployments. @@ -40,7 +40,7 @@ Use pull requests to propose changes and collaborate with your team before mergi ## Preview deployments -Preview deployments create temporary URLs where you can see your changes before they go live. +Preview deployments create temporary URLs where you can see your rendered changes before they go live. Use preview deployments to gather feedback on how changes. ### Access preview deployments @@ -60,3 +60,23 @@ Share the preview deployment URL with team members to gather feedback. Previews ### Preview authentication 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. + +## 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. + +When you open a page, the editor saves the path in the URL. Copy the URL from your browser's address bar to share it with teammates who have access to the editor. + +The URL format is: + +``` +https://dashboard.mintlify.com/{org}/{project}/editor/{branch}?file={filepath} +``` + +For example, `https://dashboard.mintlify.com/acme/docs/editor/main?file=guides/quickstart.mdx` opens `quickstart.mdx` on the `main` branch. + +Anyone with access to your Mintlify organization can use the link to open the file directly in the editor. + + + When you share a page, tell people which branch you're working on so they can confirm they view the correct version. +