Merge branch 'DECENTRALIZEDCLIMATE:develop' into develop

gitflowCheetSheet_EN.md

@@ -0,0 +1,181 @@
+# CHEETSHEET DE GIT Y GITFLOW
+
+
+
+## GIT 
+
+---
+
+### Comandos de Git basicos o frecuentes
+
+
+```shell
+
+$ git init # Crear un nuevo git
+ 
+$ git add # Agregar archivos al area de preparacion
+ 
+$ git status # Estado del repositorio
+ 
+$ git # commit -m pasar archivos del area de preparacion al repositorio local
+ 
+$ git log # ver las versiones de archivos del repositorio
+ 
+$ git clone # clonar un repositorio remoto
+ 
+$ git push # modificar el repositorio remoto, con su nueva actualizacion
+ 
+$ git pull # actualizar tu repositorio local con la ultima version del remoto
+ 
+$ git add . # sirve para agregar todos los archivos modificados al area de preparacion
+
+```
+
+---
+
+## GIT FLOW 
+---
+
+### Instalar en linux debian
+Para instalar git flow, se requiere tener previamente git, y se executan los siguientes comandos en tu terminal ya sea con sudo o como root.
+
+```
+
+$ sudo apt-get update
+
+$ sudo apt-get install git-flow
+
+```
+
+
+
+### INICIALIZAR
+Una vez que estas dentro de tu directorio git o repositorio clonado, inicializa el git flow:
+```
+
+$ git flow init
+
+```
+
+### RAMAS DE GIT FLOW
+
+![](https://www.campingcoder.com/post/20180412-git-flow.png)
+
+* **Master**: Rama principal que mantiene la version estable de un software.
+* **Develop**: Rama que se utiliza por uno o varios programadores para un software en modo pruebas. 
+* **Feature**: Rama temporal o local, que sirve para que cada programador desarrolle alguna funcion especifica (Libreria, funcion, clase, etc.). 
+* **Release**: Rama temporal solo para publicar las etiquetas de versiones y sincronizar develop con master, esto se hace cuando tenemos una version estable de software o un punto para entregable.
+* **Hotfix**: Rama temporal que se utiliza para arreglar errores criticos o bugs en el codigo de produccion, generalmente se utiliza en modo de emergencia.
+
+
+#### FEATURES
+
+
+---
+
+
+**1. COMENZAR UNA CARACTERISTICA (FEATURE)**
+
+```
+$ git flow feature start MYFEATURE
+
+```
+> Cambiar `MYFEATURE` por el nombre que le quieras dar a tu característica.
+---
+
+**2. FINALIZAR UNA CARACTERISTICA**
+
+```
+
+$ git flow feature finish MYFEATURE # Finaliza el desarrollo de una cacteristica.
+
+$OBTENIENDO CARACTERISTICAS PUBLICADAS
+
+$ git flow feature pull origin MYFEATURE # Obten una caracteristica publicada por otro.
+
+$ git flow feature track MYFEACTURE # Puedes mantener un seguimiento de tus cambios.
+
+
+```
+
+#### RELEASE
+---
+
+**COMO PUBLICAR UNA VERSION**
+
+```
+$ git checkout master
+ 
+$ git pull
+ 
+$ git checkout develop
+ 
+$ git pull
+ 
+$ git flow release start 1.0
+ 
+$ git flow release publish 1.0
+ 
+$ git flow release finish 1.0
+ 
+$ git push origin --all --follow-tags
+
+```
+
+---
+
+#### HOTFIX
+---
+
+**COMO PUBLICAR HACER UN HOTFIX**
+
+```
+
+$ git checkout develop
+ 
+$ git pull
+ 
+$ git checkout master
+ 
+$ git pull
+ 
+$ git flow hotfix star (Nombre)
+ 
+# Hacer cambios
+ 
+$ git status # verifique el archivo de color rojo
+ 
+$ git add . # agregar archivos
+ 
+$ git commit -m 'Escribe un comentario'
+ 
+$ git flow hotfix finish (name)
+ 
+# Recuerda poner una etiqueta de versión fija 1.2.x por ejemplo 1.2.2
+# estabas en el maestro, y luego debes estar en la rama de desarrollo
+ 
+$ git push origin --all --follow-tags
+ 
+```
+
+## LICENSE
+
+```
+Copyright (C) 2023 DECENTRALIZED CLIMATE FOUNDATION A.C.
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3
+or any later version published by the Free Software Foundation;
+with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+A copy of the license is included in the section entitled "GNU
+Free Documentation License". 
+```
+
+## CONTACTO Y DESARROLLADORES
+> Work developed in collaboration with the [Decentralized Climate Foundation](https://decentralizedclimate.org).
+
+- [Gustavo Bermudez](nizaries44@gmail.com)
+
+## REFERENCIAS
+\[1\]  Daniel Kummer, "Git-flow cheatsheet", https://client.aragon.org/#/decentralizedclimate/, 2023.
+
+\[2\] www.campingcoder.com, "How to use git flow", https://www.campingcoder.com/2018/04/how-to-use-git-flow/, 2023.