mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
a8f27a0fca
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
126 lines
7.0 KiB
Plaintext
126 lines
7.0 KiB
Plaintext
---
|
|
title: "Colaborar en el editor web"
|
|
sidebarTitle: "Colaborar"
|
|
description: "Edita la documentación con tu equipo mediante colaboración en tiempo real, cursores en vivo, enlaces compartibles del editor, branches y flujos de revisión con pull requests."
|
|
keywords: ["editor", "collaboration", "real-time", "live editing", "branches", "pull requests", "preview deployments", "share links"]
|
|
---
|
|
|
|
Colabora con tu equipo en la documentación usando edición en tiempo real y flujos de trabajo basados en branches.
|
|
|
|
<div id="real-time-collaboration">
|
|
## Colaboración en tiempo real
|
|
</div>
|
|
|
|
Varias personas pueden editar la misma página al mismo tiempo. Los cambios de cada persona aparecen para todos los que están en la página.
|
|
|
|
Para colaborar en una página en tiempo real, comparte el enlace del editor de esa página con tus compañeros. Consulta [Compartir enlaces del editor](#share-editor-links) más abajo.
|
|
|
|
<Frame>
|
|
<img src="/images/editor/editor-light.png" className="block dark:hidden" alt="Editor web mostrando colaboración en tiempo real con varios cursores" />
|
|
<img src="/images/editor/editor-dark.png" className="hidden dark:block" alt="Editor web mostrando colaboración en tiempo real con varios cursores" />
|
|
</Frame>
|
|
|
|
<div id="how-real-time-editing-works">
|
|
### Cómo funciona la edición en tiempo real
|
|
</div>
|
|
|
|
Cuando varios miembros del equipo editan la misma branch, los cambios se sincronizan en tiempo real. Las actualizaciones de contenido de la página, la estructura de navegación y la configuración del sitio aparecen automáticamente para todos los colaboradores sin necesidad de actualizar.
|
|
|
|
- El cursor y las ediciones de cada persona son visibles para todos los que están en la página, con los avatares y nombres de los usuarios mostrados en la barra de herramientas.
|
|
- Los cambios se fusionan automáticamente. Que dos personas editen la misma sección no provoca conflictos.
|
|
- Deshacer solo afecta a tus propios cambios; deshacer no revierte las ediciones de otra persona.
|
|
- Si pierdes la conexión de red, tus ediciones se guardan localmente y se sincronizan cuando vuelves a conectarte.
|
|
|
|
<div id="see-the-agents-edits-in-real-time">
|
|
## Ver las ediciones del agente en tiempo real
|
|
</div>
|
|
|
|
Cuando el [agente de Mintlify](/es/agent) edita una página mediante la API o MCP, aparece en el editor web como cualquier otro colaborador. Si tienes la página abierta en la misma branch, verás el avatar y el nombre del agente en la parte superior del editor y un cursor en vivo en la ubicación de su edición más reciente.
|
|
|
|
Úsalo para:
|
|
|
|
- Ver cómo los cambios del agente se transmiten a la página en tiempo real.
|
|
- Saber qué párrafo o bloque acaba de actualizar el agente sin tener que hacer un diff del archivo.
|
|
- Coordinarte con tus compañeros y el agente en la misma branch sin sobrescribir el trabajo de los demás.
|
|
|
|
El cursor del agente se borra automáticamente poco después de que el agente termina de editar.
|
|
|
|
<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. Si no conoces Git, consulta [Conceptos básicos de Git para el editor web](/es/editor/git-essentials).
|
|
|
|
<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 [Branching and publishing](/es/editor/publish) para obtener más informació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 en el editor. Los cambios adicionales se envían automáticamente a 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, los revisores obligatorios la hayan aprobado 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 tus cambios.
|
|
|
|
Cada vez que publicas cambios en una branch, la implementación de vista previa se actualiza automáticamente.
|
|
|
|
<div id="access-preview-deployments">
|
|
### Acceder a las implementaciones de vista previa
|
|
</div>
|
|
|
|
1. Haz clic en **Publish** en la barra de herramientas del editor.
|
|
2. Haz clic en la URL de vista previa para abrir la implementación de vista previa en una pestaña nueva. El formato de la URL es `organization-branch-name.mintlify.app`.
|
|
|
|
<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 publicas 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 actualizaciones en tiempo real o para dirigir a tus compañeros a una página específica.
|
|
|
|
La URL del editor se actualiza automáticamente a medida que navegas entre páginas. Copia la URL de la barra de direcciones de tu navegador para compartirla con los compañeros que tengan acceso al editor.
|
|
|
|
El formato de la URL es: `https://dashboard.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}`
|
|
|
|
Por ejemplo, `https://dashboard.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx` abre `quickstart.mdx` en la branch `main`.
|
|
|
|
Cualquier persona con acceso a tu organización de Mintlify puede usar el enlace para abrir el archivo directamente en el editor.
|