Colaborar en un proyecto de Github

Supongamos que encontramos una libreria en Github que no resuelve algún problema de nuestro código, pero queremos agregar funcionalidad o mejorar alguna rutina de la misma, enseguida enlistaremos los pasos para hacer un pull request de algún proyecto en github.

1.- Ir a la página del proyecto y crear un fork de éste.

2.- Ahora ya tenemos un fork del proyecto en nuestra cuenta.

3.- El siguiente paso es clonar el repositorio:

git clone git@github.com:yorch81/php-telegram-cli-client.git

4.- El siguiente paso es agregar la URL del repositorio original y verificamos.

git remote add upstream git@github.com:zyberspace/php-telegram-cli-client.git
git remote -v

5.- Una vez que agregamos el repositorio original, jalamos los últimos cambios.

git pull -r upstream master

6.- Después creamos una rama, para no modificar la rama master.

git checkout -b quit_whites

7.- Ya estando en nuestra rama creada, podemos empezar a hacer cambios y subirlos a nuestro repositorio y subimos los cambios a nuestra rama creada.

git add --all

git commit -m "Mis cambios"

git push origin quit_whites

8.- Ahora vamos a github, seleccionamos nuestra rama y pulsamos el botón "Compare & pull request" para notificar al propietario del repositorio original que queremos subir algunos cambios, esta acción nos manda a un formulario donde podemos agregar descripciones de los cambios que hemos enviado.

Publicar libreria en nuget.org

Nuget es un repositorio de librerías para .Net y mono, lo primero que necesitamos para publicar alguna librería es crear una cuenta en https://www.nuget.org/ o usar alguna cuenta de microsoft.

Una vez creada la cuenta debemos instalar nuget en nuesta máquina, podemos ir al siguiente enlace y descargarlo https://docs.nuget.org/create/creating-and-publishing-a-package, para  instalarlo podemos solamente copiarlo al HOME de Windows (C:/Windows/).

Ya teniendo instalado nuget, copiamos la libreria que queramos subir a un directorio cualquiera, dentro de ese directorio creamos un folder llamado lib y copiamos la librería. El siguiente paso es abrir una linea de comando (cmd.exe) en la carpeta donde copiamos la librería y ejecutamos el siguiente comando:

C:/v3sdk/nuget spec V3Sdk.dll

Donde V3Sdk.dll es la librería que queremos publicar, esto nos genera un archivo V3Sdk.dll.nuspec que es un XML que debemos editar con las especificaciones de nuestra libreria.

Ya editado el archivo nuspec ejecutamos el siguiente comando para crear el paquete:

C:/v3sdk/nuget pack V3Sdk.dll.nuspec

El resultado de este comando nos genera el archivo V3Sdk.dll.1.0.0.nupkg, que es el paquete que podemos subir a nuget.org.

Podemos ir a las siguiente url https://www.nuget.org/packages/upload para agregar nuestro paquete, escogemos el paquete generado y damos click en upload.

El siguiente paso es editar las especificaciones y aceptar para publicar.

Una vez publicado el paquete nuget tarda alrededor de 5 minutos en hacer pública la libreria.