Colaborar en el editor web

Colabora en la documentación con tu equipo mediante branches, solicitudes de extracción e implementaciones de vista previa.

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.

​

Colaboración basada en branches

Utiliza branches para trabajar en paralelo en actualizaciones de la documentación sin afectar tu sitio en producción.

​

Por qué usar branches

• 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.

​

Flujo de trabajo recomendado

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.

1. Crear una solicitud de extracción

   Crea una solicitud de extracción desde el editor cuando estés listo para publicar tus cambios. Consulta Publicar cambios en el editor web para obtener más información sobre el uso de solicitudes de extracción.

2. Revisar solicitudes de extracción

   Revisa las solicitudes de extracción en tu proveedor de Git como GitHub o GitLab.

3. 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.

4. 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.

​

Implementaciones de vista previa

Las implementaciones de vista previa crean URL temporales donde puedes ver tus cambios antes de que se publiquen.

​

Acceder a las implementaciones de vista previa

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.

​

Compartir vistas previas

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.

​

Autenticación en vista previa

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 de tu dashboard para restringir el acceso a los miembros autenticados de la organización.