mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
65c0d2ae25
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
103 lines
5.0 KiB
Plaintext
103 lines
5.0 KiB
Plaintext
---
|
|
title: "Colaborar en el editor web"
|
|
sidebarTitle: "Colaborar"
|
|
description: "Colabora en la documentación con tu equipo mediante branches, solicitudes de extracción, implementaciones de vista previa y enlaces del editor para compartir."
|
|
keywords: ["editor", "collaboration", "branches", "pull requests", "preview deployments", "share links"]
|
|
---
|
|
|
|
Colabora con tu equipo en la documentación mediante flujos de trabajo basados en branches, solicitudes de extracción e implementaciones de vista previa.
|
|
|
|
Si no conoces Git, consulta [Conceptos de Git](/es/guides/git-concepts).
|
|
|
|
<div id="branch-based-collaboration">
|
|
## Colaboración basada en branches
|
|
</div>
|
|
|
|
Utiliza branches para trabajar en paralelo en actualizaciones de la documentación sin afectar tu sitio en producción.
|
|
|
|
<div id="why-use-branches">
|
|
### Por qué usar branches
|
|
</div>
|
|
|
|
* **Aislar cambios**: Trabaja en actualizaciones sin afectar tu documentación en producción.
|
|
* **Revisar antes de publicar**: Obtén comentarios del equipo antes de publicar los cambios.
|
|
* **Trabajo en paralelo**: Varios miembros del equipo pueden trabajar en diferentes branches al mismo tiempo.
|
|
|
|
<div id="recommended-workflow">
|
|
## Flujo de trabajo recomendado
|
|
</div>
|
|
|
|
Las solicitudes de extracción te permiten proponer cambios y colaborar con tu equipo antes de fusionarlos con tu documentación en producción. Este flujo de trabajo garantiza que tu equipo revise los cambios antes de publicarlos y mantiene un historial claro de actualizaciones.
|
|
|
|
<Steps>
|
|
<Step title="Crear una solicitud de extracción">
|
|
Crea una solicitud de extracción desde el editor cuando estés listo para publicar tus cambios. Consulta <a href="/es/editor/publish">Publicar cambios en el editor web</a> para obtener más información sobre el uso de solicitudes de extracción.
|
|
</Step>
|
|
|
|
<Step title="Revisar solicitudes de extracción">
|
|
Revisa las solicitudes de extracción en tu proveedor de Git como GitHub o GitLab.
|
|
</Step>
|
|
|
|
<Step title="Responder a los comentarios">
|
|
Cuando los revisores soliciten cambios, realiza los cambios solicitados y guarda tus cambios. Se actualizarán automáticamente en la solicitud de extracción existente.
|
|
</Step>
|
|
|
|
<Step title="Fusionar solicitudes de extracción">
|
|
Fusiona tu solicitud de extracción cuando se hayan abordado todos los cambios solicitados, la solicitud de extracción haya sido aprobada por los revisores obligatorios y se hayan superado todas las comprobaciones automatizadas.
|
|
</Step>
|
|
</Steps>
|
|
|
|
<div id="preview-deployments">
|
|
## Implementaciones de vista previa
|
|
</div>
|
|
|
|
Las implementaciones de vista previa crean URL temporales donde puedes ver tus cambios antes de que se publiquen. Usa las implementaciones de vista previa para recopilar comentarios sobre los cambios.
|
|
|
|
<div id="access-preview-deployments">
|
|
### Acceder a las implementaciones de vista previa
|
|
</div>
|
|
|
|
1. Haz clic en **Share** en la barra de herramientas del editor.
|
|
2. Haz clic en **Preview** para abrir la implementación de vista previa en una pestaña nueva.
|
|
3. La URL de vista previa muestra tu documentación con todos los cambios guardados aplicados.
|
|
|
|
<Frame>
|
|
<img src="/images/editor/share-preview-light.png" className="block dark:hidden" alt="Botón «Share» en la barra de herramientas del editor" />
|
|
|
|
<img src="/images/editor/share-preview-dark.png" className="hidden dark:block" alt="Botón «Share» en la barra de herramientas del editor" />
|
|
</Frame>
|
|
|
|
<div id="share-previews">
|
|
### Compartir vistas previas
|
|
</div>
|
|
|
|
Comparte la URL de la implementación de vista previa con los miembros del equipo para recopilar comentarios. Las vistas previas se actualizan automáticamente cuando guardas cambios adicionales.
|
|
|
|
<div id="preview-authentication">
|
|
### Autenticación en vista previa
|
|
</div>
|
|
|
|
Las URL de vista previa son de acceso público de forma predeterminada. Habilita la autenticación en vista previa en la página de [Add-ons](https://dashboard.mintlify.com/products/addons) de tu dashboard para restringir el acceso a los miembros autenticados de la organización.
|
|
|
|
<div id="share-editor-links">
|
|
## Compartir enlaces del editor
|
|
</div>
|
|
|
|
Comparte un enlace directo a una página específica del editor con tu equipo. Usa enlaces del editor para colaborar en las actualizaciones y realizar cambios en las páginas.
|
|
|
|
Cuando abres una página, el editor guarda la ruta de la página en la URL. Copia la URL de la barra de direcciones de tu navegador para compartirla con los miembros del equipo que tienen acceso al editor.
|
|
|
|
El formato de la URL es:
|
|
|
|
```
|
|
https://dashboard.mintlify.com/{org}/{project}/editor/{branch}?file={filepath}
|
|
```
|
|
|
|
Por ejemplo, `https://dashboard.mintlify.com/acme/docs/editor/main?file=guides/quickstart.mdx` abre `quickstart.mdx` en la rama `main`.
|
|
|
|
Cualquier persona con acceso a tu organización de Mintlify puede usar el enlace para abrir el archivo directamente en el editor.
|
|
|
|
<Tip>
|
|
Cuando compartas una página, indica en qué rama estás trabajando para que puedan confirmar que están viendo la versión correcta.
|
|
</Tip>
|