Primera colaboración Open Source

📚 Tabla de contenido

• 📍 Aspectos Generales
• 📑 Detalles
• 🔖 Guía de colaboración desde cero
  • 1- Hacer fork del repositorio original
  • 2- Clonar el repositorio de forma local
  • 3- Realizar modificaciones
  • 4- Subir los cambios locales hacia el repositorio copia
  • 5- Crear un pull request
  • 6- Asignar issues resueltos
  • Actualizar repositorio copia luego de haber unido los cambios propuestos
• 📍 Recomendaciones

📍 Aspectos Generales

El objetivo de la iniciativa es explicar un poco sobre cómo realizar contribuciones a proyectos Open Source, los cuales en este caso están alojados en la plataforma GitHub.

La guía está enfocada a personas que apenas empiezan en el uso del controlador de versiones Git y de la plataforma GitHub.

Un punto importante de la guía es; ayudar a las personas a ganar confianza en realizar colaboraciones a proyectos publicados a lo largo de Internet y, que sea uno de los primeros pasos para sembrar la cultura de seguir investigando por cuenta propia, aparte, para ampliar el panorama del alcance que puede llegar a tener el realizar colaboraciones de este tipo.

Esta iniciativa fué creada debido al evento Hacktoberfest 2020.

📑 Detalles

Para poder completar el Hacktoberfest es necesario crear cuatro Pull Request(PR) a repositorios públicos dentro de GitHub. Pueden ser varios Pull Request(PR) dentro del mismo repositorio.

Esta guía debe de servir como ayuda para poder completar con éxito el Hacktoberfest.

Dentro de esta guía existen cinco carpetas de las cuales dentro de cada una se encuentra la maquetación HTML de una Lading Page(página de inicio), cuya maquetación cuenta con un nivel básico de diseño y que no tiene mayor complejidad.

Para cada diseño existe una cantidad de tareas(issues), cada una de ellas respectivamante etiquetadas para saber a qué Landing Page pertenece la tarea. Las tareas(issues) no son complicadas y son de modificaciones sencillas para facilitar la colaboración. Cada tarea cuenta con una descripción bastante clara de lo que se debe de realizar.

La idea propuesta sería realizar un PR en cada una de las Landing Pages hasta completar la cantidad de cuatro.

Para poder ver el listado de tareas hay que entrar en la pestaña de issues de este repositorio y elegir la tarea en la que se considere tener la capacidad de colaborar. Varias personas pueden participar en la misma tarea ya que ninguna colaboración terminará siendo unida(hacer merge) al repositorio por que el objetivo es solamente simular el proceso de colaboración en un proyecto.

🤔 ¿Cualquier persona puede participar y colaborar en este repositorio? Sí, toda ayuda es bien recibida y más aún cuando sea para mejorar la experiencia de las personas participantes de esta iniciativa. Solamente existen condiciones de colaboración en las tareas de cada Landing Page.

🤔 ¿Existe una forma en la cual mi colaboración no sea tomada en cuenta? Sí, para completar el Hacktoberfest deben de ser cuatro PR válidos, es decir que no hayan sido marcados como spam, si uno de los PR es marcado como tal, no cuenta. Dentro de este repositorio existen condiciones para dar como válida una colaboración.

🤔 ¿Por qué motivos un PR puede ser marcado como spam? En este caso será cuando la persona que realiza colaboración ya tenga experiencia en colaborar en proyectos Open Source y que solamente está buscando tareas sencillas para poder completar el Hacktoberfest. Esta iniciativa está enfocada a personas que no tienen experiencia o poco conocimientos sobre colaborar en Internet. Si la colaboración es de alguien con experiencia y solamente es corrección de texto, no cuenta, debe de ser algo que genere valor al proyecto y que será evaluado por la persona administradora del repositorio.

👋🏽 Nota de redacción: Si has llegado hasta este punto de la lectura, ¡que bueno!. Si consideras que esta iniciativa puede ayudarle a más personas el hecho de compartirla puede ser de ayuda, no necesariamente tiene que ser de forma pública a través de redes sociales, puedes hacerlo de la forma que encuentres más conveniente para que pueda llegar a la mayor cantidad posible de entusiastas. Espero que puedas ganar más confianza para colaborar en proyectos Open Source y poder completar el Hacktoberfest :)

No se nace sabiendo algo, hay que prácticar tarde o temprano. Gracias por tu atención.

🔖 Guía de colaboración desde cero

Guía con imagenes sobre los pasos para poder resolver los issues en cada una de las landing pages. Leer el texto de las indicaciones con atención.

Requerimientos:

• Instalar git
• Tener un editor de texto instalado

1- Hacer fork del repositorio original

Luego de presionar en fork se podrá ver el proceso mientras se crea una copia del repositorio y en el cual se puede hacer modificaciones.

Luego de haber hecho la copia se puede observar que no se está en la ruta del repositorio original. El texto forked from quiere decir que se trata de un copia y por lo tanto tiene una ruta diferente al repositorio original.

2- Clonar el repositorio de forma local

Luego de haber copiado el repositorio se debe de clonar de forma local en la computadora que se está usando, para ello es necesario presionar sobre el botón de Code, luego, en el icono similar a un hoja. Lo que se copia es la URL del repositorio.

Posterior de haber copiado el enlace del repositorio, es necesario abrir una consola en la computadora, la ruta de la consola puede ser en cualquier lugar siempre y cuando se recuerde la ruta.

En consola ejecutar el comando;

git clone https://URL-DEL-REPOSITORIO-COPIADO

Una vez el paso de clonar el repositorio haya terminado, se tiene que entrar en la carpeta del repositorio. Si se revisan las carpetas dentro de la carpeta del repositorio clonado, se podrán observar las carpetas de cada landing page.

3- Realizar modificaciones

Si el editor de texto que utilizas es Visual Studio Code, te recomiendo utilizar la extensión Live Server para poder visualizar los cambios de una manera más fácil porque se actualiza de forma automática.

Posterior de entrar en la carpeta y haber elegido una landing page que modificar, se tiene que abrir el editor de texto de preferencia y completar los issues que la landing page tiene asignados.

En el caso de la siguiente imagen, se abrió la carpeta de la landing page 1 y, se modificó el nombre de una de las opciones del menú.

Una vez hecho los cambios y guardados, se debe de regresar a la consola y ejecutar el comando;

git status

git status permite ver cuales han sido los archivos que han sufrido cambios, en este caso el archivo index.html de la landing page 1

Una vez revisado qué archivos fueron modificados, se tiene que ejecutar el comando;

git add .

El comando git add . agrega todos los archivos modificados en un registro que luego será enviado hacia el repositorio que es copia.

Luego de agregar los archivos al registro, es necesario confirmar los cambios para que sean agregados al historial de modificaciones, con el comando;

git commit -m "Modificando landing page 1"

Lo que está dentro de las comillas dobles es el mensaje que se le asigna, este mensaje puede ser el que se desee aunque, se recomienda que sea descriptivo por que servirá más adelante para temas de historial de cambios.

4- Subir los cambios locales hacia el repositorio copia

Una vez se confirmaron los cambios, se tienen que enviar de el repositorio local en la computadora, hacia el repositorio que es copia y que se encuentra en GitHub, con el comando;

git push origin master

5- Crear un pull request

Luego que se han subido los cambios, se puede notar en el repositorio copia de GitHub el mensaje; This branch is 1 commit ahead of ..., esto quiere decir que la copia tiene una modificación que el repositorio original no tiene.

Para poder proponer estos cambios al repositorio original, lo que se tiene que hacer es algo llamado Pull request, que es una solicitud para que acepten los cambios recién hechos, en este caso el cambio hecho en la landing page 1.

Una vez presionado en Pull Request se mostrará lo cambios que se quieren enviar hacia el repositorio original. Luego de revisar si todo está bien, es hora de confirmar que se quiere hacer una petición para proponer modificaciones en el repositorio original, para ello hay que presionar sobre Create pull request

Luego de presionar sobre Create pull request se mostrará el repositorio original, esto se puede saber porque en el título ya no aparece forked from ..

En la página ahora se mostrará un formulario para hacer la solicitud que se acepten los cambios. Se pueden agregar detalles como el título de la solicitud, la descripción de los cambios que se quieren proponer.

Una vez redactada la solicitud, se tiene que presionar sobre Create pull request, que es la acción que oficialmente propone los cambios para que las personas que son propietarias del repositorio original puedan revisarlos.

6- Asignar issues resueltos

Luego de haber creado el Pull request se procede a enlazar los issues que fueron resueltos, en el caso de las landing pages, cada una ya los tiene asignados. Estas asignaciones son para llevar un mejor control y orden del repositorio, entre más especificas sean las relaciones, mejor.

Se presiona el icono en la sección de Linked issues y se mostrará un listado con barra de búsqueda, seleccionar los issues que están siendo resueltos y listo.

![14-add-issue-link](https://user-images.githubuserconten