¡Bienvenido! ??
Good First Issue es una iniciativa para seleccionar selecciones fáciles de proyectos populares, de modo que los desarrolladores que nunca han contribuido al código abierto puedan comenzar rápidamente.
Los mantenedores de código abierto siempre buscan involucrar a más personas, pero los nuevos desarrolladores generalmente piensan que es un desafío convertirse en contribuyentes. Creemos que lograr que los desarrolladores solucionen problemas muy sencillos elimina la barrera para futuras contribuciones. Por eso existe Good First Issue.
Le invitamos a agregar un nuevo proyecto en Good First Issue y alentamos todos los proyectos, antiguos y nuevos, grandes y pequeños.
Siga estos sencillos pasos:
Nuestro objetivo es limitar los proyectos para nuevos contribuyentes de código abierto. Para mantener la calidad de los proyectos en Good First Issue, asegúrese de que su repositorio de GitHub cumpla con los siguientes criterios:
Tiene al menos tres números con la etiqueta good first issue . Esta etiqueta ya está presente en todos los repositorios de forma predeterminada. Si no, puedes seguir los pasos aquí.
Tiene al menos 10 contribuyentes.
Contiene un README.md con instrucciones detalladas de configuración para el proyecto y un CONTRIBUTING.md con pautas para nuevos contribuyentes.
Se mantiene activamente.
Agregue la ruta de su repositorio (en orden lexicográfico) en data/repositories.toml.
Crea una nueva solicitud de extracción. Agregue el enlace a la página de problemas del repositorio en la descripción del PR. Una vez que se fusione la solicitud de extracción, los cambios estarán disponibles en goodfirstissue.dev.
Good First Issue tiene dos componentes: la aplicación de interfaz de usuario creada con Nuxt.js y un script de llenado de datos escrito en Python.
Para aportar nuevas funciones y cambios al sitio web, querrá ejecutar la aplicación localmente. Siga estos pasos:
Clona el proyecto localmente. Asegúrese de tener Python 3 y una versión reciente de Node.js instalado en su computadora.
Haga una copia de los archivos de datos de muestra para que los use su aplicación local y cámbieles el nombre al nombre de archivo que espera la aplicación. Este paso es importante, ya que la aplicación front-end no funcionará sin estos archivos de datos.
$ cp datos/generado.sample.json datos/generado.json $ cp datos/etiquetas.sample.json datos/etiquetas.json
Cree la aplicación front-end e inicie el servidor de desarrollo.
$ bun install # instalar las dependencias$ bun dev # iniciar el servidor de desarrollo
La aplicación debería abrirse en su navegador.
