Flujo de trabajo para escribir textos con otrxs en GitHub
Pensando en cómo escribir con otros en GitHub, buscando y buscando encontré esta fuente de inspiración
El procedimiento simplificado sería:
- Abrir un repositorio nuevo con un archivo README.md en él estarían las instrucciones y el índice
- Cada colaborador tendría que: sacarse una cuenta e informar para sumarlo al equipo
- La primer tarea consistiría en hacer un aporte al README.md
Algunas aclaraciones:
- Un branch, una rama (Github usa como metáfora la estructura de los arboles) sería el tronco principal, (voy a usar el nombre en inglés BRANCH) llamado master esta rama es considerada estable
- Las actualizaciones o modificaciones se hacen en ramas separadas de la rama master
- cuando una actualización está lista para ser mergeada (esto quiere decir mezclada con la rama estable master) se crea un “pull request” (pedido de subida a rama master)
- El pull request es revisado por un miembro del grupo, marcando y trabajando en él los cambio que se tienen que hacer (rol de editor)
- Cuando el pull request es aprobado, la rama que contiene los cambios es mezclada en la rama estable master.
Esto en la práctica sería así:
- Alvar escribe el README.md implementando la estructura básica y algunas cuestiones iniciales
- Daniel cliquea en un botón y crea una rama nueva con su propia versión del documento. No tiene que bajarse ningún archivo, ni crear copias ni renombrar nada. Github se hace cargo de esto. Daniel puede hacer todo los cambios que quiera sin preocuparse de estar modificando nada del documento principal. Daniel agrega nuevas secciones al índice, crea archivos nuevos para las nuevas partes del índice e incluso corrige algunos errores que Alvar pasó por alto en el archivo README.md
- Daniel considera que sus cambios están listos para ser mezclados (mergeados) en el documento principal, así que crea un pull request (haciendo un solo click)
- GitHub notifica automáticamente al equipo que Daniel abrió un pull request
- Cualquiera del equipo puede, rápidamente, ver exactamente que se ha cambiado. Línea a línea, palabra a palabra.
- Alejandra ve el trabajo de Daniel y se da nota algunas cuestiones gramaticales, entonces se las anota en los comentarios del pull request de Daniel.
- Daniel corige esos errores, Alejandra aprueba el pull request (de nuevo, con un solo click) y los cambios se mezclan en el documento principal.