Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion es/dashboard/roles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Las organizaciones con roles ampliados tienen seis roles: propietario, administr
Solo puedes invitar a miembros o asignar roles hasta tu propio rol.

- **Propietario**: Todo lo que puede hacer un administrador, además de eliminar el proyecto, eliminar la organización y transferir la propiedad. Cada organización tiene un propietario, que al principio es la persona que la crea.
- **Administrador**: Control total sobre el contenido, los miembros, los roles y la configuración, incluida la facturación y el dominio personalizado. Los administradores pueden publicar sin revisión.
- **Administrador**: Control total sobre el contenido, los miembros, los roles y la configuración, incluida la facturación y el dominio personalizado. Los administradores pueden publicar sin revisión, a menos que tu deployment branch tenga protección de branch.
- **Publicador**: Todo lo que puede hacer un editor, además de publicar cambios y aprobar [solicitudes de revisión](/es/editor/review#require-review-before-publishing).
- **Editor**: Crear y editar contenido, comentar, solicitar revisiones y gestionar la configuración del sitio y del espacio de trabajo, las integraciones, las claves de API y el assistant. Los editores no pueden publicar ni aprobar revisiones.
- **Comentarista**: Todo lo que puede hacer un lector, además de comentar en páginas.
Expand Down
1 change: 1 addition & 0 deletions es/editor/publish.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ Haga clic en **Publish** en la barra de herramientas para ver sus cambios pendie
| <Tooltip tip="La branch que publica en su sitio, normalmente 'main'." headline="Deployment branch">Deployment branch</Tooltip> | Ninguna | **Publish** directamente en su sitio publicado |
| Deployment branch | Requiere pull requests | **Create branch** para mover el trabajo a una branch nueva |
| Deployment branch con [Require review before publishing](/es/editor/review#require-review-before-publishing) activado | Ninguna | **Request review**. Los admins también pueden usar **Publish** directamente |
| Deployment branch con [Require review before publishing](/es/editor/review#review-with-a-protected-deployment-branch) activado | Protegida, en GitHub.com | **Create branch** y luego **Request review** en la branch nueva |
| <Tooltip tip="Una branch aislada donde trabaja en actualizaciones antes de hacer merge en su deployment branch." headline="Feature branch">Feature branch</Tooltip> | Ninguna | **Request review** y luego **Merge and publish** |
| Feature branch con [Require review before publishing](/es/editor/review#review-changes-on-a-branch) activado | Ninguna | **Request review** y luego **Publish approved changes** cuando los revisores aprueben todas las páginas. Los admins también pueden usar **Publish** directamente |
| Feature branch en un repositorio alojado por Mintlify, sin aprobaciones obligatorias | Ninguna | **Publish** para hacer merge de la branch en su deployment branch |
Expand Down
24 changes: 22 additions & 2 deletions es/editor/review.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ Para dirigir a un compañero a una página concreta de una branch, haga clic en
Para requerir revisión antes de publicar, debe tener un [plan Enterprise](https://mintlify.com/pricing?ref=review) y el repositorio de su proyecto debe estar en GitHub.
</Info>

Si un admin activa [Require review before publishing](/es/editor/settings#require-review-before-publishing), los cambios en su deployment branch y en las branches que crea en el editor necesitan la aprobación de un compañero antes de que un admin o publisher pueda publicarlos. Los admins pueden publicar sus propios cambios sin revisión.
Si un admin activa [Require review before publishing](/es/editor/settings#require-review-before-publishing), los cambios en su deployment branch y en las branches que crea en el editor necesitan la aprobación de un compañero antes de que un admin o publisher pueda publicarlos. Los admins pueden publicar sus propios cambios sin revisión, a menos que su deployment branch tenga protección de branch.

En una branch, los revisores aprueban cada página en el editor, igual que en su deployment branch. Consulte [Revisar cambios en una branch](#review-changes-on-a-branch).

Expand Down Expand Up @@ -96,7 +96,7 @@ Los cambios que no pertenecen a una página, como la navegación, la configuraci

Mientras una página está en una solicitud de revisión abierta, la barra lateral muestra **In review** junto a ella. Después de que un revisor aprueba la página, la barra lateral muestra **Approved**.

Los admins pueden publicar sin revisión, pero también pueden solicitar una revisión desde el menú **Publish**.
Los admins pueden publicar sin revisión en una deployment branch sin protección, pero también pueden solicitar una revisión desde el menú **Publish**.

<div id="review-and-approve-changes">

Expand Down Expand Up @@ -172,10 +172,30 @@ Una revisión en una branch abarca toda la branch. Cada página de la branch mue
- Si edita la branch después de la aprobación, o alguien envía un cambio a ella en Git, el banner muestra **You edited this branch after it was approved** o **This branch changed in git after it was approved**. Haga clic en **Request review again** para pedir a los revisores que la revisen de nuevo.
- Las páginas que elimina en la branch también forman parte de la revisión. Aparecen como **Removed** y los revisores las aprueban como cualquier otra página. El enlace de una página eliminada en el banner de revisión abre la página de su deployment branch en una pestaña nueva.
- Si la branch ya no cambia una página solicitada, la página sale de la solicitud de revisión.
- Las revisiones que los compañeros dejan en la pull request de la branch en GitHub aparecen en la solicitud de revisión y en la [bandeja de entrada](/es/dashboard/inbox) como referencia. No cuentan como aprobaciones en el editor.
- Si otra persona publicó un cambio en la misma parte de una página, el menú de publicación muestra **Can't publish these changes** y desactiva **Publish**. Los admins pueden hacer clic en **View request** para resolver el conflicto. Los demás deben pedir ayuda a un admin.

En una [sub-branch](/es/editor/publish#sub-branches), el menú de publicación sigue mostrando **Publish to** su deployment branch y **Merge into** la branch principal.

<div id="review-with-a-protected-deployment-branch">

### Revisar con una deployment branch protegida

</div>

Si su deployment branch tiene protección de branch, aún puede requerir revisión antes de publicar cuando su repositorio está en GitHub.com. Los repositorios de GitHub Enterprise Server con una deployment branch protegida no pueden usar este ajuste.

1. En su deployment branch, haga clic en **Create branch** para mover sus cambios a una branch nueva.
1. Haga clic en **Request review** y elija a los revisores. Mintlify abre la pull request de la branch, o marca su pull request en borrador como lista para revisión, y luego envía la solicitud de revisión.
1. Los revisores abren la solicitud desde su bandeja de entrada y hacen clic en **Approve** en el editor.
1. Después de la aprobación, un admin o publisher hace clic en **Publish approved changes**.

Si un revisor ha [conectado su cuenta de GitHub](/es/dashboard/profile#connect-github), aprobar en el editor también aprueba la pull request en GitHub para el commit que revisó. Si su protección de branch requiere una aprobación de GitHub y el revisor no ha conectado GitHub, el editor le pide que conecte su cuenta primero.

Al publicar, solo se hace merge de la versión de la branch que aprobaron los revisores. Si edita la branch después de la aprobación, solicite una revisión de nuevo. Las comprobaciones de merge de GitHub, como las comprobaciones de estado obligatorias, siguen aplicándose.

Con una deployment branch protegida, los admins no pueden publicar sin revisión. Las aprobaciones hechas directamente en GitHub no cuentan como aprobaciones en el editor.

<div id="review-and-merge-pull-requests">

## Revisar y hacer merge de pull requests
Expand Down
2 changes: 1 addition & 1 deletion es/editor/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Cuando requiere revisión antes de publicar, solo los admins pueden publicar cam

- Solo los admins pueden activar o desactivar este ajuste.
- Requerir revisiones antes de publicar desactiva la [publicación automática](#auto-publish).
- No puede activar este ajuste mientras su deployment branch tenga protección de branch. Para usarlo, desactive la protección de branch en su deployment branch en GitHub. Para conservar la protección de branch, revise los cambios mediante [pull requests](/es/editor/review#review-and-merge-pull-requests).
- Si su deployment branch tiene protección de branch, su repositorio debe estar en GitHub.com. En ese caso, las revisiones se hacen en branches y los admins no pueden publicar sin revisión. Consulte [Revisar con una deployment branch protegida](/es/editor/review#review-with-a-protected-deployment-branch).
- Las revisiones funcionan en su deployment branch y en las branches que crea en el editor. En una branch, un admin o publisher puede publicar una vez que los revisores aprueban todas las páginas modificadas. Consulte [Revisar cambios en una branch](/es/editor/review#review-changes-on-a-branch).

<div id="create-draft-pull-requests-by-default">
Expand Down
2 changes: 1 addition & 1 deletion fr/dashboard/roles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Les organisations avec des rôles étendus disposent de six rôles : propriétai
Vous ne pouvez inviter des membres ou attribuer des rôles que jusqu'à votre propre rôle.

- **Propriétaire** : Tout ce que peut faire un administrateur, plus la suppression du projet, la suppression de l'organisation et le transfert de propriété. Chaque organisation a un seul propriétaire, qui est d'abord la personne qui la crée.
- **Administrateur** : Contrôle total sur le contenu, les membres, les rôles et les paramètres, y compris la facturation et le domaine personnalisé. Les administrateurs peuvent publier sans relecture.
- **Administrateur** : Contrôle total sur le contenu, les membres, les rôles et les paramètres, y compris la facturation et le domaine personnalisé. Les administrateurs peuvent publier sans relecture, sauf si votre deployment branch est protégée.
- **Publieur** : Tout ce que peut faire un éditeur, plus la publication des modifications et l'approbation des [demandes de relecture](/fr/editor/review#require-review-before-publishing).
- **Éditeur** : Créer et modifier du contenu, commenter, demander des relectures et gérer les paramètres du site et de l'espace de travail, les intégrations, les clés d'API et l'assistant. Les éditeurs ne peuvent ni publier ni approuver des relectures.
- **Commentateur** : Tout ce que peut faire un lecteur, plus la possibilité de commenter les pages.
Expand Down
1 change: 1 addition & 0 deletions fr/editor/publish.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ Cliquez sur **Publish** dans la barre d'outils pour voir vos modifications en at
| <Tooltip tip="La branch qui publie vers votre site publié, généralement 'main'." headline="Deployment branch">Deployment branch</Tooltip> | Aucune | **Publish** directement vers votre site publié |
| Deployment branch | Pull requests requises | **Create branch** pour déplacer votre travail vers une nouvelle branch |
| Deployment branch avec [Require review before publishing](/fr/editor/review#require-review-before-publishing) activé | Aucune | **Request review**. Les admins peuvent aussi utiliser **Publish** directement |
| Deployment branch avec [Require review before publishing](/fr/editor/review#review-with-a-protected-deployment-branch) activé | Protégée, sur GitHub.com | **Create branch**, puis **Request review** sur la nouvelle branch |
| <Tooltip tip="Une branch isolée sur laquelle vous travaillez avant de fusionner dans votre deployment branch." headline="Feature branch">Feature branch</Tooltip> | Aucune | **Request review**, puis **Merge and publish** |
| Feature branch avec [Require review before publishing](/fr/editor/review#review-changes-on-a-branch) activé | Aucune | **Request review**, puis **Publish approved changes** une fois que les relecteurs ont approuvé toutes les pages. Les admins peuvent aussi utiliser **Publish** directement |
| Feature branch dans un dépôt hébergé par Mintlify, sans approbation requise | Aucune | **Publish** pour fusionner la branch dans votre deployment branch |
Expand Down
24 changes: 22 additions & 2 deletions fr/editor/review.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ Pour diriger un collègue vers une page précise d'une branch, cliquez sur <Icon
Pour exiger une relecture avant publication, vous devez disposer d'un [forfait Enterprise](https://mintlify.com/pricing?ref=review) et le dépôt de votre projet doit être sur GitHub.
</Info>

Si un admin active [Require review before publishing](/fr/editor/settings#require-review-before-publishing), les modifications sur votre deployment branch et sur les branches que vous créez dans l'éditeur doivent être approuvées par un collègue avant qu'un admin ou un publisher puisse les publier. Les admins peuvent publier leurs propres modifications sans relecture.
Si un admin active [Require review before publishing](/fr/editor/settings#require-review-before-publishing), les modifications sur votre deployment branch et sur les branches que vous créez dans l'éditeur doivent être approuvées par un collègue avant qu'un admin ou un publisher puisse les publier. Les admins peuvent publier leurs propres modifications sans relecture, sauf si votre deployment branch est protégée.

Sur une branch, les relecteurs approuvent chaque page dans l'éditeur, de la même façon que sur votre deployment branch. Consultez [Relire les modifications sur une branch](#review-changes-on-a-branch).

Expand Down Expand Up @@ -96,7 +96,7 @@ Les modifications qui n'appartiennent à aucune page, comme la navigation, les p

Tant qu'une page fait partie d'une demande de relecture ouverte, la barre latérale affiche **In review** à côté d'elle. Après qu'un relecteur a approuvé la page, la barre latérale affiche **Approved**.

Les admins peuvent publier sans relecture, mais ils peuvent aussi demander une relecture depuis le menu **Publish**.
Les admins peuvent publier sans relecture sur une deployment branch non protégée, mais ils peuvent aussi demander une relecture depuis le menu **Publish**.

<div id="review-and-approve-changes">

Expand Down Expand Up @@ -172,10 +172,30 @@ Une relecture sur une branch couvre toute la branch. Chaque page de la branch af
- Si vous modifiez la branch après l'approbation, ou si quelqu'un y pousse une modification dans Git, la bannière affiche **You edited this branch after it was approved** ou **This branch changed in git after it was approved**. Cliquez sur **Request review again** pour demander aux relecteurs de la relire.
- Les pages que vous supprimez sur la branch font aussi partie de la relecture. Elles apparaissent comme **Removed**, et les relecteurs les approuvent comme n'importe quelle autre page. Le lien d'une page supprimée dans la bannière de relecture ouvre la page de votre deployment branch dans un nouvel onglet.
- Si la branch ne modifie plus une page demandée, la page quitte la demande de relecture.
- Les relectures que vos collègues laissent sur la pull request de la branch dans GitHub apparaissent dans la demande de relecture et dans la [boîte de réception](/fr/dashboard/inbox) à titre indicatif. Elles ne comptent pas comme des approbations dans l'éditeur.
- Si quelqu'un d'autre a publié une modification de la même partie d'une page, le menu de publication affiche **Can't publish these changes** et désactive **Publish**. Les admins peuvent cliquer sur **View request** pour résoudre le conflit. Les autres doivent demander de l'aide à un admin.

Sur une [sous-branch](/fr/editor/publish#sub-branches), le menu de publication affiche toujours **Publish to** votre deployment branch et **Merge into** la branch parente.

<div id="review-with-a-protected-deployment-branch">

### Relire avec une deployment branch protégée

</div>

Si votre deployment branch a une protection de branch, vous pouvez quand même exiger une relecture avant publication lorsque votre dépôt est sur GitHub.com. Les dépôts GitHub Enterprise Server dont la deployment branch est protégée ne peuvent pas utiliser ce paramètre.

1. Sur votre deployment branch, cliquez sur **Create branch** pour déplacer vos modifications vers une nouvelle branch.
1. Cliquez sur **Request review** et choisissez des relecteurs. Mintlify ouvre la pull request de la branch, ou marque sa pull request en brouillon comme prête à être relue, puis envoie la demande de relecture.
1. Les relecteurs ouvrent la demande depuis leur boîte de réception et cliquent sur **Approve** dans l'éditeur.
1. Après l'approbation, un admin ou un publisher clique sur **Publish approved changes**.

Si un relecteur a [connecté son compte GitHub](/fr/dashboard/profile#connect-github), approuver dans l'éditeur approuve aussi la pull request dans GitHub pour le commit qu'il a relu. Si votre protection de branch exige une approbation GitHub et que le relecteur n'a pas connecté GitHub, l'éditeur lui demande d'abord de connecter son compte.

La publication ne fusionne que la version de la branch que les relecteurs ont approuvée. Si vous modifiez la branch après l'approbation, demandez à nouveau une relecture. Les vérifications de fusion de GitHub, comme les status checks requis, s'appliquent toujours.

Avec une deployment branch protégée, les admins ne peuvent pas publier sans relecture. Les approbations faites directement dans GitHub ne comptent pas comme des approbations dans l'éditeur.

<div id="review-and-merge-pull-requests">

## Réviser et fusionner les pull requests
Expand Down
2 changes: 1 addition & 1 deletion fr/editor/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Lorsque vous exigez une relecture avant publication, seuls les admins peuvent pu

- Seuls les admins peuvent activer ou désactiver ce paramètre.
- Exiger des relectures avant publication désactive la [publication automatique](#auto-publish).
- Vous ne pouvez pas activer ce paramètre tant que votre deployment branch a une protection de branch. Pour l'utiliser, désactivez la protection de branch sur votre deployment branch dans GitHub. Pour conserver la protection de branch, relisez plutôt les modifications via des [pull requests](/fr/editor/review#review-and-merge-pull-requests).
- Si votre deployment branch a une protection de branch, votre dépôt doit être sur GitHub.com. Les relectures se font alors sur des branches, et les admins ne peuvent pas publier sans relecture. Consultez [Relire avec une deployment branch protégée](/fr/editor/review#review-with-a-protected-deployment-branch).
- Les relectures fonctionnent sur votre deployment branch et sur les branches que vous créez dans l'éditeur. Sur une branch, un admin ou un publisher peut publier une fois que les relecteurs ont approuvé chaque page modifiée. Consultez [Relire les modifications sur une branch](/fr/editor/review#review-changes-on-a-branch).

<div id="create-draft-pull-requests-by-default">
Expand Down
2 changes: 1 addition & 1 deletion zh/dashboard/roles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Mintlify 提供三种 dashboard 访问级别:查看者、编辑者和管理员
你只能邀请成员或分配不高于你自己角色的角色。

- **所有者**:拥有管理员的所有权限,还可以删除项目、删除组织和转移所有权。每个组织只有一位所有者,最初是创建该组织的人。
- **管理员**:完全控制内容、成员、角色和设置,包括账单和自定义域名。管理员可以不经审阅直接发布。
- **管理员**:完全控制内容、成员、角色和设置,包括账单和自定义域名。管理员可以不经审阅直接发布,除非你的 deployment branch 启用了分支保护。
- **发布者**:拥有编辑者的所有权限,还可以发布更改和批准[审阅请求](/zh/editor/review#require-review-before-publishing)。
- **编辑者**:创建和编辑内容、发表评论、请求审阅,以及管理站点和工作区设置、集成、API 密钥和 assistant。编辑者无法发布或批准审阅。
- **评论者**:拥有查看者的所有权限,还可以评论页面。
Expand Down
Loading
Loading