Flujo de trabajo para escribir textos con otrxs en GitHub

boss

Pensando en cómo escribir con otros en GitHub, buscando y buscando encontré esta fuente de inspiración

El procedimiento simplificado sería:

  1. Abrir un repositorio nuevo con un archivo README.md en él estarían las instrucciones y el índice
  2. Cada colaborador tendría que: sacarse una cuenta e informar para sumarlo al equipo
  3. La primer tarea consistiría en hacer un aporte al README.md

Algunas aclaraciones:

  1. 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
  2. Las actualizaciones o modificaciones se hacen en ramas separadas de la rama  master
  3. 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)
  4. 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)
  5. 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í:

  1. Alvar  escribe el README.md implementando la estructura básica y algunas cuestiones iniciales
  2. 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
  3. 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)
  4. GitHub notifica automáticamente al equipo que Daniel abrió un pull request
  5. Cualquiera del equipo puede, rápidamente, ver exactamente que se ha cambiado. Línea a línea, palabra a palabra.
  6. 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.
  7. Daniel corige esos errores, Alejandra aprueba el pull request (de nuevo, con un solo click) y los cambios se mezclan en el documento principal.
 

Escenas del Mapatón | Mapeo colectivo Área Reconquista

Crónica y escenas del mapeo colectivo que se inció el 14/11

 

Plantilla Camino del Héroe | Inglés, Prácticas del Lenguaje y HTML

camino del héroe

Plantilla del proyecto Camino del Héroe.

PASOS A SEGUIR

  1. Ir a la plantilla de edición del comic
  2. Hacer click en el botón remix
  3. Loguearse
  4. Cambiar titulo y agregar sus nombres
  5. Guardar
  6. Comenzar a editar en la linea:110
 

LaTex | Capítulo 1

tipeando

Qué es LaTeX

LaTeX es un programa para la composición de textos. No es un procesador de textos, sino un sistema de armado de documentos. LaTex es Libre y Abierto. Fue escrito originalmente por Leslie Lamport y se basa en el TeX Typesetting engine de Donalc Knuth.

Cómo nos podemos beneficiar de él

LaTeX esta especialmente indicado para documentaciones técnicas o científicas. Es legendaria su superior composición tipográfica (typesetting) de formulas matemáticas. Si sos estudiante o científico, entonces LaTeX es tu mejor opción para la preparación y escritura de documentación. Aunque esto va también para todo aquel que hace de la escritura y la publicación de textos parte de su profesión. Produce documentos de muy alta calidad, es extremadamente estable y maneja documentos complejos de forma sencilla, sin importar cuan grandes sean.

 

Leer más