[desarrollo] Colaborar en un proyecto de Github: 2 formas

 [desarrollo] 

Colaborar en un proyecto de Github: 

2 formas

En github, el sitio web que usa git, para la gestión de versiones de software, hay dos formas de colaborar en el desarrollo de un proyecto:

a)   Subir cambios pero el coordinador del proyecto se encarga de aceptar o rechazar los cambios.

Del proyecto se crea un fork, (una copia del proyecto), que podrás modificar y subir cambios (a tu fork), y cuando lo estimes oportuno, le mandas tus cambios al coordinador del proyecto (Pull Request) , para que este decida si admite los cambios o no y los mezcle con la rama actual.

 Esta forma lo he visto explicado en muchos sitios, y es ideal por su facilidad, para proyectos como añadir traducciones a programas. Lo he visto explicado en varias páginas, os dejo los enlaces:

Cómo colaborar en un proyecto en GitHub

http://playdoces.appspot.com/documentation/1.2.4/github

b) Todos colaboran, no hay coordinador.

Esta forma es más sencilla, me la explico Tincho (del foro de gambas-es.org) ya que los colaboradores suben sus cambios y se mezclan con el proyecto principal, sin necesidad de que alguien (el coordinador o creador del proyecto), tenga que decidir si se mezclan o aceptan los cambios. Aquí es muy importante, la organización y coordinación de los colaboradores, para evitar que aparezcan problemas de sincronización. Por ejemplo decidir que archivos va a modificar cada uno, (para que no se pisen los cambios). Una herramienta útil para estas conversaciones puede ser https://gitter.im

Estos son los pasos para añadir colaboradores a un proyecto de github:

1. ir a tu proyecto 
2. ir a la solapa settings
3. Escribir el nombre del colaborador y cuando lo encuentras le das al botón de agregar.

Nota:
 El colaborador, tiene que tener cuenta en github, para que aparezca en la lista de "Collaborators"

Una vez hecho esto, el colaborador recibe un mensaje en la cuenta de correo que tenga asociada a github, para aceptar la colaboración :

y partir de ese momento, le va a aparecer el proyecto en su lista de proyectos, y podrá bajar / subir los cambios como si fuera un proyecto suyo.




Otros enlaces de interes:
https://github.com/oslugr/curso-git/blob/master/texto/solucion_problemas.md
Mi chuletilla de comandos de git:
http://jsbsan.blogspot.com.es/2015/05/breves-notas-sobre-git-y-github.html



Fuentes:
https://www.gambas-es.org/viewtopic.php?f=5&t=5989&highlight=github&start=10

Breves notas sobre git y github

Breves notas sobre git y github

Para desarrollara varios proyectos, he usado el control de versiones svn alojadolo en Coogle Code. Como este va a desaparecer, pues ellos mismos te dan la herramienta para que los portes  a github.  Es una herramienta muy cómoda y lo hace todo ella en un rato.

El caso es que ya tengo los proyectos portados a github, y voy a poner una breve guia para poderlos usar en mi ordenador. Sera algo muy básico Y lo pongo como notas para mi, y lo subo al blog, por si a alguién le interesa

1) Instalar git en tu ordenador
$sudo apt-get install git



2) Creamos una carpeta para alojar el proyecto
$mkdir  ProyectoPruebaGitHub
$cd  ProyectoPruebaGitHub

3) Configuramos git:
$git config --global user.name "Nombre que quieras mostrar"
4) Bajamos el proyecto:
$ git clone https://github.com/jsbsan/damasinglesas

 Y se crea una carpeta llamada "damasinglesas"

5) Hacemos algun cambio, modificando alguna linea, o añadiendo algun archivo.
Con la orden:
$ git status

Nos informa de lo que hemos cambiado con respecto al servidor

6)Actualizamos los cambios 

$git add .

7) Enviando Cambios: Commit y push

Y para actualilzar la copia del servidor, hacemos commit:
$git commit -m "Cambios del dia de hoy"
Y luego
$git push
(nos pedirá la nombre de usuario y clave de github)

8) Recibiendo Cambios:
Si han añadido algo al proyecto, otros programadores, debemos actualizarnos y recibir esos cambios
$git pull

---

Colaborar entre Programadores usando github:
http://jsbsan.blogspot.com.es/2016/12/desarrollo-colaborar-en-un-proyecto-de.html

---

Nota: 10/12/2016
Ignorar archivos y directorios en la gestión de versiones:

Si tenemos definido un archivo de texto .gitignore, donde le hemos dicho que archivos o directorios no se tengan en cuenta.El comando seria asi:
$git config --global core.excludesfile ~/.gitignore
El fichero .gitignore que he echo para gambas es el siguiente:

#ignorar este directorio

.gambas/*

.gambas/

#archivos temporales

*~

#ejecutable .gambas

*.gambas

Asi no me sube los ficheros  *.gambas, que normalmente son grandes, ni los temporales *~ 

Si vuestro proyecto ya esta en funcionamiento, y habéis echo varios commit, tendréis que borrar esos  directorio/ficheros usando la orden:
$ git rm --cached <file>

Sustituirmos <file> por nuestro archivo/directorio

Para más información:
http://es.gitready.com/beginner/2009/01/19/ignoring-files.html



Nota: 19/05/2016
Para borrado de archivos y/o directorios
git rm miarchivo
git rm -r micarpeta

Nota: 14/09/2016
Para añadir tag:
$ git tag -a [tagname] -m "texto"

Ejemplo:
$ git tag -a v1.4 -m "mi version 1.4"

Mostrar etiquetas de un proyecto:
$ git tag

y también, que muestra mas información:
$ git show

Compartir  etiqueta en el servidor online:
git push origin [tagname]




Fuente:
https://git-scm.com/book/es/v1/Fundamentos-de-Git-Creando-etiquetas

Nota: 05/12/2016
Listar commit hechos:
$git log


Nota: 26/12/2016
Video donde se explica, teniendo ya un proyecto ya iniciado en nuestro ordenador, usar git y github para tenerlo gestionado y subido a la nube.

Fuente:

http://www.bufa.es/git-borrar-archivos-carpetas/

Para más información:
http://www.edy.es/dev/docs/git-guia-rapida/

Fuentes:
https://github.com/oslugr/curso-git/blob/master/texto/uso_basico.md
https://github.com/jsbsan/damasinglesas
https://github.com/jsbsan/