first issues

Accueillir! ?

First Issues est une initiative visant à organiser des choix faciles à partir de projets open source, de sorte que les développeurs qui n'ont jamais contribué à l'ouverture open peuvent commencer rapidement.

Les agents open source cherchent toujours à impliquer davantage de personnes, mais les nouveaux développeurs pensent généralement qu'il est difficile de devenir contributeur. Nous pensons que les développeurs résolvent les problèmes super faciles suppriment la barrière des contributions futures. C'est pourquoi le premier problème existe.

Ajout d'un nouveau projet

Vous êtes invités à ajouter un nouveau projet dans Firstissues.dev, et nous encourageons tous les projets - anciens et nouveaux, grands et petits.

Suivez ces étapes simples:

• Notre objectif est de réduire les projets pour les nouveaux contributeurs open source. Pour maintenir la qualité des projets dans le premier numéro, assurez-vous que votre référentiel GitHub répond aux critères suivants:

  • Il a au moins trois problèmes avec le good first issue . Cette étiquette est déjà présente sur tous les référentiels par défaut. Sinon, vous pouvez suivre les étapes ici.

  • Il compte au moins 10 contributeurs.

  • Il contient un Readme.md avec des instructions de configuration détaillées pour le projet et un contribution.md avec des directives pour les nouveaux contributeurs.

  • Il est activement maintenu.

• Ajoutez le chemin de votre référentiel (dans l'ordre lexicographique) dans Data / RepOS.json.

• Créez une nouvelle request de traction. Veuillez ajouter le lien à la page des problèmes du référentiel dans la description de PR. Une fois la demande de traction fusionnée, les modifications seront en direct sur Firstissues.dev.

Configuration du projet localement

Firstissues est construite à l'aide de NextJS.

Pour contribuer de nouvelles fonctionnalités et modifications au site Web, vous voudriez exécuter l'application localement. Veuillez suivre ces étapes:

1. Clone le projet localement. Assurez-vous d'avoir Python 3 et une version récente de Node.js installée sur votre ordinateur.

2. Ajouter GitHub_Token, Mongodb_uri dans .env Fichier (voir .env.local pour référence)

3. Créez l'application frontale et démarrez le serveur de développement.

$ npm install # install the dependencies
$ npm run dev # start the development server

L'application doit tourner sur votre navigateur.

Nage

Après avoir terminé les étapes ci-dessus, votre application sera opérationnelle. Mais, votre base de données est vide. Il doit être peuplé.

 GET http://localhost:3000/api/cron

Exécutez ce point de terminaison à partir de l'application / navigateur Postman. Cela prendra un certain temps. Cela remplira votre DB avec des données essentielles pour commencer.