first issues

Willkommen! ?

Die ersten Ausgaben sind eine Initiative, um einfache Auswahl aus Open-Source-Projekten zu kuratieren. Daher können Entwickler, die noch nie zu Open-Source beigetragen haben, schnell beginnen.

Open-Source-Betreuer wollen immer mehr Menschen involviert, aber neue Entwickler halten es im Allgemeinen für eine Herausforderung, Mitwirkender zu werden. Wir glauben, dass Entwickler die Behebung von super einfachen Problemen dazu bringen, die Barriere für zukünftige Beiträge zu beseitigen. Deshalb existiert die erste Ausgabe.

Hinzufügen eines neuen Projekts

Sie können ein neues Projekt in FirstIssues.dev hinzufügen, und wir ermutigen alle Projekte - alt und neu, groß und klein.

Befolgen Sie diese einfachen Schritte:

• Unser Ziel ist es, Projekte für neue Open-Source-Mitwirkende einzugrenzen. Um die Qualität der Projekte in der ersten Ausgabe aufrechtzuerhalten, stellen Sie bitte sicher, dass Ihr Github -Repository die folgenden Kriterien erfüllt:

  • Es hat mindestens drei Probleme mit dem good first issue Ausgabeetikett. Dieses Etikett ist standardmäßig in allen Repositories vorhanden. Wenn nicht, können Sie hier die Schritte ausführen.

  • Es hat mindestens 10 Mitwirkende.

  • Es enthält eine Readme.md mit detaillierten Setup -Anweisungen für das Projekt und einen Beitrag.

  • Es wird aktiv aufrechterhalten.

• Fügen Sie den Pfad Ihres Repositorys (in lexikografischer Reihenfolge) in Daten/repos.json hinzu.

• Erstellen Sie eine neue Pull-Request. Bitte fügen Sie den Link zu der Ausgabenseite des Repositorys in der PR -Beschreibung hinzu. Sobald die Pull -Anfrage zusammengeführt wurde, werden die Änderungen auf FirstInsues.dev live sein.

Das Projekt lokal einrichten

FirstIssues wird mit NextJs gebaut.

Um neue Funktionen und Änderungen auf der Website beizutragen, möchten Sie die App lokal ausführen. Bitte befolgen Sie diese Schritte:

1. Klonen Sie das Projekt lokal. Stellen Sie sicher, dass Sie Python 3 und eine aktuelle Version von Node.js auf Ihrem Computer installiert haben.

2. Fügen Sie Github_Token, mongoDB_uri in .Env -Datei hinzu (siehe.

3. Erstellen Sie die Front-End-App und starten Sie den Entwicklungsserver.

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

Die App sollte sich in Ihrem Browser drehen.

Säen

Nachdem die oben genannten Schritte ausgeschlossen sind, wird Ihre App in Betrieb sein. Aber Ihre Datenbank ist leer. Es muss besiedelt werden.

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

Führen Sie diesen Endpunkt aus der Postman -App / Browser aus. Es wird einige Zeit dauern. Dadurch werden Ihre DB mit wesentlichen Daten ausgelöst, um loszulegen.