Saltar al contenido principal
Git es un sistema de control de versiones que te permite realizar un seguimiento de los cambios en tu documentación y colaborar con los miembros del equipo. Con Git, para cada archivo de tu proyecto puedes ver qué cambió, cuándo y por qué. Git también facilita volver a versiones anteriores de los archivos si alguna vez lo necesitas. El editor web realiza algunas operaciones de Git en segundo plano. Comprender estos conceptos te ayudará a trabajar de forma más eficaz con el editor web y a colaborar con los miembros del equipo que trabajan en sus entornos de desarrollo locales.

​
Conceptos fundamentales de Git

La fuente de tu documentación, donde se almacenan todos los archivos y su historial. El editor web se conecta a tu repositorio para acceder al contenido y modificarlo.
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.
Una branch apunta a una confirmación específica en tu repositorio. Tu documentación en producción se compila a partir de una rama de implementación. Puedes tener cualquier cantidad de otras branches con cambios que aún no se han publicado en tu documentación en producción. Si deseas incorporar los cambios de una branch en tu documentación en producción, puedes fusionarla en tu rama de implementación mediante una solicitud de extracción.Usa branches para trabajar en cambios sin afectar tu documentación en producción, experimentar de forma segura con nuevas funcionalidades y obtener revisiones antes de publicar.
La branch principal de tu proyecto desde la cual se compila el contenido de tu documentación en producción. Los cambios en esta branch se publican automáticamente en tu sitio de documentación. A menudo se llama main, pero puedes establecer cualquier branch como tu rama de implementación.
Una forma de proponer fusionar tus cambios en una branch en tu documentación en producción. Permite revisión y discusión antes de que los cambios se publiquen. Comúnmente llamada PR, y también denominada merge request en GitLab.
Un diff (o diferencia) muestra los cambios entre dos versiones de un archivo. Al revisar solicitudes de extracción, los diffs resaltan lo que se agregó, eliminó o modificó, lo que facilita identificar qué cambió.

​
Cómo utiliza Git el editor web

El editor web se conecta a tu repositorio de Git mediante la Aplicación de GitHub o la integración con GitLab y automatiza operaciones comunes de Git. Cuando:
  • Abres un archivo: El editor obtiene la versión más reciente de tu repositorio y garantiza que siempre trabajes con contenido actualizado.
  • Realizas cambios: El editor registra tus cambios como un borrador que puede convertirse en una confirmación cuando estés listo para guardar tu trabajo.
  • Guardar cambios: El editor realiza una confirmación con tus cambios, preservando tu trabajo en el historial del proyecto.
  • Creas una branch: El editor crea una nueva branch en tu repositorio que puede ser utilizada por cualquier persona con acceso al repositorio para colaborar y revisar cambios.
  • Publicas en tu rama de implementación: El editor realiza una confirmación y hace push directamente a tu rama de implementación, lo que publica tus cambios de inmediato.
  • Publicas en otras branches: El editor crea una solicitud de extracción, lo que te permite recibir comentarios de otras personas antes de fusionar tus cambios en tu rama de implementación.

​
Mejores prácticas de Git

Cada equipo desarrollará sus propios flujos de trabajo y preferencias, pero estas son algunas prácticas recomendadas generales para empezar.
  • Escribe mensajes de confirmación descriptivos: Sé específico sobre qué cambió usando un lenguaje activo.
  • Usa nombres de branch descriptivos: Los nombres de branch deben explicar el trabajo que se está realizando y ser significativos para alguien que esté viendo las branches en tu repositorio.
  • Mantén las branches enfocadas: Mantén los cambios en una branch enfocados en una tarea o proyecto específicos.
  • Elimina las branches después de hacer merge: Elimina las branches cuando ya no las necesites para mantener tu repositorio ordenado.
⌘I