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
1 change: 0 additions & 1 deletion api/preview/trigger.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
title: "Trigger preview deployment"
openapi: "/openapi.json POST /project/preview/{projectId}"
keywords: ["preview", "preview deployment", "branch preview", "staging"]

---

Use this endpoint to programmatically create or update a preview deployment for a Git branch. If a preview already exists for the specified branch, the endpoint triggers a redeployment instead of creating a duplicate.
Expand Down
4 changes: 2 additions & 2 deletions deploy/preview-deployments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging
Preview deployments require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=preview-deployments).
</Info>

Preview deployments let you see how changes to your docs look before merging to production. Each preview creates a shareable URL that updates automatically as you push new changes.
Preview deployments let you see how changes to your docs look before merging to production. Each preview creates a shareable URL that updates automatically as you push new changes.

Preview URLs are publicly viewable by default. Share a preview link with anyone who needs to review your changes.

Expand Down Expand Up @@ -111,7 +111,7 @@ Password-protect a specific preview to share it with external reviewers without

Preview deployments stay live as long as their source branch exists in your repository and continue to receive updates on every push.

- **Automatic previews**: The preview for a pull request remains available while the PR is open and after it's merged or closed, as long as the source branch still exists. When you delete the branch, the next dashboard sync removes the preview.
- **Automatic previews**: The preview for a pull request remains available while the pull request is open and after it's merged or closed, as long as the source branch still exists. When you delete the branch, the next dashboard sync removes the preview.
- **Manual previews**: Manual previews stay live until you delete them. Redeploying a manual preview refreshes its content against the latest commit on the specified branch.
- **Delete a preview**: In your [dashboard](https://app.mintlify.com/), go to **Previews**, open the preview, and click **Delete** to remove it immediately.

Expand Down
2 changes: 1 addition & 1 deletion es/deploy/preview-deployments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ Protege con contraseña una vista previa específica para compartirla con reviso

Las implementaciones de vista previa se mantienen activas mientras la rama de origen exista en tu repositorio y siguen recibiendo actualizaciones con cada push.

- **Vistas previas automáticas**: La vista previa de una pull request permanece disponible mientras la PR esté abierta y después de que se fusione o cierre, siempre que la rama de origen siga existiendo. Eliminar la rama elimina la vista previa en la siguiente sincronización del dashboard.
- **Vistas previas automáticas**: La vista previa de una pull request permanece disponible mientras la pull request esté abierta y después de que se fusione o cierre, siempre que la rama de origen siga existiendo. Eliminar la rama elimina la vista previa en la siguiente sincronización del dashboard.
- **Vistas previas manuales**: Las vistas previas manuales permanecen activas hasta que las eliminas. Volver a desplegar una vista previa manual actualiza su contenido con el último commit de la rama especificada.
- **Eliminar una vista previa**: En tu [dashboard](https://app.mintlify.com/), ve a **Previews**, abre la vista previa y haz clic en **Delete** para eliminarla de inmediato.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: "Por qué las solicitudes de extracción de forks y las ramas de fo
keywords: ["fork pull request", "no preview link", "preview deployment missing", "fork branch preview", "trigger preview API fork", "external contributor preview"]
---

Si una solicitud de extracción abierta desde un fork no muestra ningún enlace de implementación de vista previa, o si una llamada al endpoint [Trigger preview deployment](/es/api/preview/trigger) con una rama de un fork falla, este es el comportamiento esperado. Mintlify no genera implementaciones de vista previa a partir de ramas de forks.
Si una solicitud de extracción abierta desde un fork no muestra ningún enlace de implementación de vista previa, este es el comportamiento esperado. Lo mismo ocurre si falla una llamada al endpoint [Trigger preview deployment](/es/api/preview/trigger) con una rama de un fork. Mintlify no genera implementaciones de vista previa a partir de ramas de forks.

La aplicación de GitHub de Mintlify debe estar instalada en un repositorio para generar una vista previa. La aplicación está instalada en tu repositorio principal, no en los forks de los colaboradores, por lo que no puede leer un fork ni generar una vista previa a partir de él. Esto se aplica tanto a las vistas previas automáticas de solicitudes de extracción como a las vistas previas activadas a través de la API. El valor de `branch` en una solicitud de API debe existir en el repositorio conectado a tu proyecto de Mintlify.

Expand Down
2 changes: 1 addition & 1 deletion fr/deploy/preview-deployments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ Protégez par mot de passe un aperçu spécifique pour le partager avec des rév

Les déploiements de prévisualisation restent disponibles tant que leur branche source existe dans votre référentiel et continuent de recevoir des mises à jour à chaque push.

- **Aperçus automatiques** : L'aperçu d'une pull request reste disponible tant que la PR est ouverte, ainsi qu'après sa fusion ou sa fermeture, à condition que la branche source existe encore. La suppression de la branche retire l'aperçu lors de la prochaine synchronisation du Dashboard.
- **Aperçus automatiques** : L'aperçu d'une pull request reste disponible tant que la pull request est ouverte, ainsi qu'après sa fusion ou sa fermeture, à condition que la branche source existe encore. La suppression de la branche retire l'aperçu lors de la prochaine synchronisation du Dashboard.
- **Aperçus manuels** : Les aperçus manuels restent disponibles jusqu'à ce que vous les supprimiez. Redéployer un aperçu manuel actualise son contenu par rapport au dernier commit de la branche spécifiée.
- **Supprimer un aperçu** : Dans votre [Dashboard](https://app.mintlify.com/), accédez à **Previews**, ouvrez l'aperçu et cliquez sur **Delete** pour le supprimer immédiatement.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: "Pourquoi les pull requests de forks et les branches de forks trans
keywords: ["fork pull request", "no preview link", "preview deployment missing", "fork branch preview", "trigger preview API fork", "external contributor preview"]
---

Si une pull request ouverte depuis un fork n'affiche aucun lien de déploiement de prévisualisation, ou si un appel à l'endpoint [Trigger preview deployment](/fr/api/preview/trigger) avec une branche de fork échoue, il s'agit du comportement attendu. Mintlify ne génère pas de déploiements de prévisualisation à partir de branches de forks.
Si une pull request ouverte depuis un fork n'affiche aucun lien de déploiement de prévisualisation, il s'agit du comportement attendu. Il en va de même si un appel à l'endpoint [Trigger preview deployment](/fr/api/preview/trigger) avec une branche de fork échoue. Mintlify ne génère pas de déploiements de prévisualisation à partir de branches de forks.

L'application GitHub Mintlify doit être installée sur un dépôt pour générer une prévisualisation. L'application est installée sur votre dépôt principal, pas sur les forks des contributeurs, elle ne peut donc pas lire un fork ni générer une prévisualisation à partir de celui-ci. Cela s'applique à la fois aux prévisualisations automatiques de pull requests et aux prévisualisations déclenchées via l'API. La valeur de `branch` dans une requête d'API doit exister dans le dépôt connecté à votre projet Mintlify.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: "Why fork pull requests and fork branches passed to the preview API
keywords: ["fork pull request", "no preview link", "preview deployment missing", "fork branch preview", "trigger preview API fork", "external contributor preview"]
---

If a pull request opened from a fork shows no preview deployment link, or a call to the [Trigger preview deployment](/api/preview/trigger) endpoint with a fork branch fails, this is expected behavior. Mintlify does not build preview deployments from fork branches.
If a pull request opened from a fork shows no preview deployment link, this is expected behavior. The same is true if a call to the [Trigger preview deployment](/api/preview/trigger) endpoint with a fork branch fails. Mintlify does not build preview deployments from fork branches.

The Mintlify GitHub App must be installed on a repository to build a preview. The app is installed on your main repository, not on contributor forks, so it cannot read a fork or build a preview against it. This applies to both automatic pull request previews and previews triggered through the API. The `branch` value in an API request must exist in the repository connected to your Mintlify project.

Expand Down
2 changes: 1 addition & 1 deletion zh/deploy/preview-deployments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging

只要预览部署对应的源 branch 仍存在于你的仓库中,预览就会持续在线,并在每次推送时接收更新。

- **自动预览**:拉取请求的预览在 PR 处于打开状态期间,以及合并或关闭后 (只要源 branch 仍存在) 都会保持可用。删除该 branch 后,预览会在下一次控制台同步时被移除。
- **自动预览**:拉取请求的预览在拉取请求处于打开状态期间,以及合并或关闭后 (只要源 branch 仍存在) 都会保持可用。删除该 branch 后,预览会在下一次控制台同步时被移除。
- **手动预览**:手动预览会一直在线,直到你删除它为止。重新部署手动预览会根据指定 branch 上的最新提交刷新其内容。
- **删除预览**:在你的[控制台](https://app.mintlify.com/)中,前往 **Previews**,打开该预览,然后点击 **Delete** 立即将其移除。

Expand Down