Identificación de dónde se puede ayudar

  • 5 minutos

En esta unidad se explica cómo puede empezar a trabajar con las contribuciones de código abierto. También se usarán incidencias y etiquetas para buscar tareas en las que contribuir.

Cualquier usuario puede usar, modificar y compartir libremente software de código abierto. Con software de código abierto, cualquiera puede ver, modificar y distribuir un proyecto para cualquier propósito. La idea detrás del software de código abierto es que el uso compartido de código conduce a un software mejor y más confiable.

Hay muchas maneras de contribuir en proyectos de código abierto. Realizar la primera contribución a menudo puede ser una experiencia aterradora, pero no debería ser así. El código abierto es un lugar para todos y las contribuciones se producen en todos los niveles.

Búsqueda de un proyecto de código abierto que necesite contribuciones

Puede empezar por pensar en los proyectos que ya utiliza, o bien que quiere usar. Contribuir es más fácil cuando está familiarizado con el proyecto y su comunidad.

Es posible que, al leer el archivo README de un proyecto, encuentre un vínculo roto o errores tipográficos. Es posible que haya observado que algo no funciona como se esperaba o que la documentación no está actualizada. Son oportunidades excelentes para ayudar y contribuir al proyecto.

Sugerencia

Una sugerencia importante: Todos los tipos de contribuciones son valiosos. El nivel de experiencia o conocimiento que tenga del proyecto no importa aquí. Todos tenemos algo que podemos aportar. Tenga confianza en sí mismo. Lo más importante aquí es la disposición a ayudar.

También puede usar la búsqueda de GitHub para explorar temas y proyectos relacionados. Vaya a la búsqueda de GitHub y escriba la palabra del tema.

Pongamos que le interesa el aprendizaje automático.

Captura de pantalla que muestra los temas de búsqueda de GitHub.

A continuación, puede restringir la búsqueda seleccionando Temas en la barra lateral izquierda.

Captura de pantalla que muestra los resultados de una búsqueda estrecha de GitHub.

Desde allí, puede encontrar repositorios relevantes para la palabra clave de búsqueda y repositorios mantenidos por miembros de la comunidad.

Familiarización con un proyecto de código abierto

Algo que merece la pena mencionar aquí es que cada comunidad de código abierto es diferente. Cuando haya encontrado un proyecto, tendrá que familiarizarse con él y sus instrucciones de participación.

La mayoría de los proyectos tendrán estos documentos en el nivel superior del repositorio:

  • LICENCIA: El proyecto debe contener una licencia de código abierto. Si el proyecto no tiene una licencia, no es de código abierto.
  • LÉAME: El archivo LÉAME normalmente sirve como página principal del proyecto. Normalmente proporciona información sobre cómo empezar a usar el proyecto. También es habitual que contenga información sobre cómo interactuar con la comunidad.
  • CONTRIBUYENDO: Como su nombre sugiere, este documento proporciona instrucciones sobre cómo contribuir al proyecto. Normalmente describe cómo funciona el proceso de contribución e incluye detalles sobre cómo configurar el entorno de desarrollo.
  • CODE_OF_CONDUCT: El código de conducta establece reglas básicas para los miembros de la comunidad. Al hacerlo, ayuda a que la comunidad sea un entorno seguro y de bienvenida para todos.

Aunque no todos los proyectos tienen documentos CONTRIBUTING o CODE_OF_CONDUCT, el hecho de tenerlos es una buena indicación de que el proyecto es participativo.

Los colaboradores y mantenedores de código abierto provienen de todos los rincones del mundo. Los proyectos suelen tener varios canales de comunicación para organizar los debates y solicitar ayuda. Una buena manera de familiarizarse con la comunidad es leer algunos de estos canales de comunicación:

  • Seguimiento de problemas: Donde los usuarios analizan problemas y tareas relacionados con el proyecto. Para encontrar incidencias en GitHub, puede ir a la página principal del repositorio en GitHub y agregar /issues al final de la dirección URL (por ejemplo, https://github.com/jupyter/notebook/issues).
  • Solicitud de incorporación de cambios: Donde los usuarios analizan y revisan los cambios en el proyecto. Se puede encontrar en GitHub si agrega pulls a la dirección URL del proyecto (por ejemplo, https://github.com/jupyter/notebook/pulls).
  • Canales de chat y foros: Algunos proyectos usan canales de chat, como Slack, Gitter e IRC, o foros como Discurso para conversaciones y discusiones.

Identificación de tareas en las que trabajar

Ha encontrado un proyecto, ha leído las instrucciones de contribución y ya está listo para enviar la suya.

Es posible que ya haya identificado algo en lo que trabajar, como la corrección de vínculos rotos o la actualización de la documentación. Una buena manera de encontrar incidencias descriptivas para los principiantes en las que ayudar consiste en visitar la dirección URL /contribute del proyecto (por ejemplo, https://github.com/jupyter/notebook/contribute).

Captura de pantalla que muestra la sección Contribuir a un proyecto en GitHub.

Observará que la mayoría de las incidencias que se muestran en la dirección URL contribute tendrán etiquetas como good-first-issue, help wanted, beginner-friendly, etc. Las etiquetas se suelen usar para proporcionar información de nivel superior de la incidencia y el tipo de ayuda que se necesita.

Puede visitar la página de etiquetas (por ejemplo, https://github.com/jupyter/notebook/labels). A continuación, seleccione incidencias que tengan etiquetas como help wanted, discussion u otras relacionadas con el tipo de contribución que le interesa.

A medida que explore las incidencias, es posible que también vea que algunas tienen vínculos a otras incidencias o solicitudes de incorporación de cambios.

Captura de pantalla que muestra una solicitud de incorporación de cambios vinculada a un problema.

Hay muchas maneras de contribuir en el código abierto. Puede apoyar financieramente a los que crean y mantienen el ecosistema de código abierto a través de código, liderazgo, tutorías, diseño y mucho más.

El código abierto se basa en gran medida en el trabajo voluntario. Los patrocinadores de GitHub le permiten financiar proyectos y usuarios para ayudarles a mantener su trabajo de código abierto, a la vez que les proporciona el reconocimiento que merecen.

Si un proyecto es apto para el patrocinio a través de patrocinadores de GitHub, encontrará un botón Patrocinador en la página principal del proyecto.

Captura de pantalla que muestra el cuadro de patrocinador en una página de proyecto de GitHub.

Puede seleccionar el nivel de patrocinio y si quiere que su contribución sea pública.

Captura de pantalla que muestra los niveles de patrocinio.

Resumen de la unidad

En esta unidad, ha obtenido información sobre cómo puede empezar a trabajar con las contribuciones de código abierto. Ahora sabe cómo elegir un proyecto en el que trabajar y usar incidencias y etiquetas de GitHub con el fin de identificar las tareas en las que trabajar.

Esta es una lista de comprobación útil para interactuar con un proyecto por primera vez:

  • ¿Tiene licencia?
  • ¿Los mantenedores y colaboradores utilizan de forma activa las incidencias y las solicitudes de incorporación de cambios?
  • ¿En el proyecto se usan etiquetas como help wanted o good first issue para los principiantes?
  • ¿El proyecto tiene un código de conducta?
  • ¿El proyecto tiene instrucciones de contribución claras?

Por último, recuerde que todas las contribuciones son bienvenidas y que el ecosistema de código abierto se beneficia en gran medida de sus ideas y su participación. Hay muchas maneras de contribuir al código abierto, desde el envío de código o la participación en debates sobre proyectos hasta el patrocinio de proyectos a través de los patrocinadores de GitHub.