Skip to main content
Git te permite controlar y hacer seguimiento de los cambios en los archivos. Git es el sistema de control de versiones preferido para flujos de trabajo de documentación como código, donde gestionas la documentación de la misma manera que cualquier otro repositorio de código. El editor web se encarga de las operaciones de Git por ti. Comprender algunos conceptos clave te ayuda a sacar el máximo provecho del editor y a colaborar con tu equipo.

​
Lo que Git hace para tu documentación

Git registra cada cambio que se hace en tu documentación. Anota qué cambió, quién lo cambió, cuándo lo cambió y por qué. Esto significa que puedes:
  • Ver el historial completo de cualquier página.
  • Deshacer cambios revirtiendo a una versión anterior.
  • Trabajar en actualizaciones sin afectar tu sitio en producción.
  • Revisar los cambios antes de que se publiquen.
Tu repositorio de documentación es la colección de archivos, y su historial, que constituyen tu sitio de documentación. El editor web se conecta a este repositorio para leer y actualizar tu contenido.

​
Conceptos clave

Estos son los conceptos de Git que encontrarás con mayor frecuencia al usar el editor web.
Una instantánea guardada de tus cambios en un momento específico. Cada confirmación incluye un mensaje que describe qué cambió y crea un registro permanente en el historial de tu proyecto.Cuando guardas cambios, el editor web crea una confirmación.
Una línea de trabajo independiente en tu repositorio. A veces se llama una feature branch.Tu sitio de documentación en producción se construye desde una rama de implementación, normalmente llamada main. Otras ramas te permiten trabajar en cambios de forma independiente. Nada en una rama afecta tu sitio en producción hasta que la fusionas con tu rama de implementación mediante una solicitud de extracción.Cuando creas una rama, el editor web crea una nueva rama en tu repositorio. Puedes cambiar entre ramas desde el menú desplegable de ramas en la barra de herramientas.
La rama que construye tu sitio de documentación en producción, normalmente llamada main. Los cambios que se fusionan en esta rama se implementan automáticamente en tu sitio.
Una propuesta para unir cambios de una rama a otra. Las solicitudes de extracción permiten que tu equipo revise y discuta los cambios antes de que se publiquen.Cuando publicas cambios en una feature branch, el editor web crea una solicitud de extracción. Tu equipo revisa y une la solicitud de extracción en tu proveedor de Git (GitHub o GitLab).
Combinar cambios de una rama en otra. Después de que tu equipo revisa y aprueba una solicitud de extracción, fusionar la rama incorpora tus cambios en la rama de implementación y los publica.
Ocurre cuando dos personas modifican de forma distinta la misma parte de un archivo. El editor ayuda a resolver cualquier conflicto que ocurra en tus ramas.
Una comparación que muestra las diferencias entre dos versiones de un archivo. Al revisar solicitudes de extracción, los diffs resaltan exactamente qué cambió.

​
Cómo se relaciona el editor con Git

Cada acción que realizas en el editor web corresponde a una operación de Git.
Tu acción en el editorOperación de Git en segundo plano
Abrir un archivoObtener la versión más reciente desde tu repositorio
Save changesCrear una confirmación, una instantánea de tus cambios en el historial del proyecto
Crear una branchCrear una branch, una línea de trabajo independiente que no afecta tu sitio en vivo a menos que decidas publicarla
Publicar en tu rama de implementaciónEnviar directamente tu confirmación, lo que inicia una implementación
Publicar en una branch de funcionalidadesCrear una solicitud de extracción, una propuesta para fusionar tus cambios en la rama de implementación