From cfa5ba169dce322d265b910a7e366be2551e66a4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 24 Sep 2026 03:31:33 +0000 Subject: [PATCH 1/2] docs: note publishes that break navigation are refused --- editor/publish.mdx | 1 + es/editor/publish.mdx | 1 + fr/editor/publish.mdx | 1 + zh/editor/publish.mdx | 1 + 4 files changed, 4 insertions(+) diff --git a/editor/publish.mdx b/editor/publish.mdx index 8b7b363643..4c41abbd65 100644 --- a/editor/publish.mdx +++ b/editor/publish.mdx @@ -64,6 +64,7 @@ A contributors icon marks files that someone other than you edited. Hover over i - Granular publishing only applies on a deployment branch without branch protections. On feature branches, publishing includes every pending change. - Deleting a folder deletes every page inside it. Those deletions publish together. You can't partially delete a folder. - Some changes depend on each other, like a page and its navigation entry. If your selection leaves out a change that a selected change depends on, the publish fails with an error. Adjust your selection to include the dependency, then publish again. +- If your selection would add a navigation error that your live site doesn't already have, such as a tab next to top-level groups, Mintlify refuses the publish. Nothing is committed and your changes stay pending. Fix the navigation errors or deselect the changes that cause them, then publish again. ## Work on a branch diff --git a/es/editor/publish.mdx b/es/editor/publish.mdx index cf1180729e..4394fa49e4 100644 --- a/es/editor/publish.mdx +++ b/es/editor/publish.mdx @@ -80,6 +80,7 @@ Un icono de colaboradores marca los archivos que ha editado alguien distinto de - La publicación granular solo se aplica en una deployment branch sin protecciones de branch. En las feature branches, la publicación incluye todos los cambios pendientes. - Eliminar una carpeta elimina todas las páginas de su interior. Esas eliminaciones se publican juntas. No puede eliminar parcialmente una carpeta. - Algunos cambios dependen entre sí, como una página y su entrada de navegación. Si su selección deja fuera un cambio del que depende un cambio seleccionado, la publicación falla con un error. Ajuste su selección para incluir la dependencia y vuelva a publicar. +- Si su selección añadiría un error de navegación que su sitio publicado aún no tiene, como una pestaña junto a grupos de nivel superior, Mintlify rechaza la publicación. No se confirma nada y sus cambios siguen pendientes. Corrija los errores de navegación o deseleccione los cambios que los causan y vuelva a publicar.
diff --git a/fr/editor/publish.mdx b/fr/editor/publish.mdx index be107aaa5e..13ecfd689c 100644 --- a/fr/editor/publish.mdx +++ b/fr/editor/publish.mdx @@ -80,6 +80,7 @@ Une icône de contributeurs marque les fichiers modifiés par une autre personne - La publication granulaire ne s'applique que sur une deployment branch sans protections de branch. Sur les feature branches, la publication inclut toutes les modifications en attente. - Supprimer un dossier supprime toutes les pages qu'il contient. Ces suppressions sont publiées ensemble. Vous ne pouvez pas supprimer partiellement un dossier. - Certaines modifications dépendent les unes des autres, comme une page et son entrée de navigation. Si votre sélection omet une modification dont dépend une modification sélectionnée, la publication échoue avec une erreur. Ajustez votre sélection pour inclure la dépendance, puis publiez à nouveau. +- Si votre sélection ajoute une erreur de navigation que votre site en ligne ne présente pas déjà, comme un onglet à côté de groupes de premier niveau, Mintlify refuse la publication. Rien n'est commité et vos modifications restent en attente. Corrigez les erreurs de navigation ou désélectionnez les modifications qui les causent, puis publiez à nouveau.
diff --git a/zh/editor/publish.mdx b/zh/editor/publish.mdx index 9a151aabaf..c6558f2aff 100644 --- a/zh/editor/publish.mdx +++ b/zh/editor/publish.mdx @@ -80,6 +80,7 @@ keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull re - 分级发布仅在没有分支保护的 deployment branch 上生效。在 feature branch 上，发布会包含所有待处理更改。 - 删除文件夹会删除其中所有页面。这些删除操作会一起发布。你无法只删除文件夹中的一部分。 - 有些更改互相依赖，例如页面及其导航条目。如果你的选择忽略了某个被选更改所依赖的更改，发布会失败并显示错误。请调整你的选择以包含该依赖，然后再次发布。 +- 如果你的选择会引入线上站点原本没有的导航错误（例如在顶级分组旁添加标签页），Mintlify 会拒绝此次发布。不会提交任何内容，你的更改仍保持待发布状态。请修复导航错误或取消选择导致错误的更改，然后再次发布。
From 1639b9ee399fac658a0147887fec1316b0733f8c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 24 Sep 2026 03:32:34 +0000 Subject: [PATCH 2/2] docs: use active voice in publish refusal note --- editor/publish.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/editor/publish.mdx b/editor/publish.mdx index 4c41abbd65..0e77a35049 100644 --- a/editor/publish.mdx +++ b/editor/publish.mdx @@ -64,7 +64,7 @@ A contributors icon marks files that someone other than you edited. Hover over i - Granular publishing only applies on a deployment branch without branch protections. On feature branches, publishing includes every pending change. - Deleting a folder deletes every page inside it. Those deletions publish together. You can't partially delete a folder. - Some changes depend on each other, like a page and its navigation entry. If your selection leaves out a change that a selected change depends on, the publish fails with an error. Adjust your selection to include the dependency, then publish again. -- If your selection would add a navigation error that your live site doesn't already have, such as a tab next to top-level groups, Mintlify refuses the publish. Nothing is committed and your changes stay pending. Fix the navigation errors or deselect the changes that cause them, then publish again. +- If your selection would add a navigation error that your live site doesn't already have, such as a tab next to top-level groups, Mintlify refuses the publish, commits nothing, and keeps your changes pending. Fix the navigation errors or deselect the changes that cause them, then publish again. ## Work on a branch