Mein erstes Hacktoberfest - Erfahrungen mit Open Source-Beiträgen als Erstes

Einen Beitrag zu Open Source und Projekten zu leisten, kann ein entmutigender Prozess sein. Ihre Lieblingssuchmaschine liefert eine Menge Ergebnisse in Handbüchern und Repositories, um loszulegen. Aber oftmals liefert Ihre Suche nicht das gewünschte Ergebnis, und Sie wissen immer noch nicht, wie Sie zu Open Source beitragen sollen, selbst nachdem Sie mehrere Blog-Beiträge gelesen haben. Der schlechte Ruf bestimmter Projekte und ein harter Unterton helfen auch nicht weiter und können die Angelegenheit noch komplizierter machen.

Ich war selbst dort. Ich durchsuchte die Seiten nach großartigen Open Source-Repositories, an denen ich mitarbeiten konnte, nur um festzustellen, dass ich nicht wusste, wie ich anfangen sollte.

Frustriert und etwas enttäuscht konzentrierte ich mich stattdessen auf andere Projekte.

Das änderte sich jedoch, als ich den Hacktoberfest-Aufkleber eines Kollegen auf seinem Laptop sah. Ich war fasziniert - war dies ein Überbleibsel eines weiteren Hackathons?

Das Hacktoberfest stellte sich als ganz anders heraus.

Was genau ist ein Hacktoberfest?

Tipp: Es hat weder mit Bier noch mit Hacking noch mit dem Oktoberfest zu tun (das tatsächlich im September stattfindet, duh!).

Das Hacktoberfest ist eine einmonatige Feier des Beitrages zu Open Source, die vom 1. Oktober bis 31. Oktober dauert. Es wurde von DigitalOcean in Zusammenarbeit mit GitHub initiiert. Im Oktober können Sie Ihre Lieblingsrepositorys auf GitHub unterstützen und Pull-Anfragen stellen. Wenn Sie es schaffen, insgesamt vier zu machen, haben Sie Anspruch auf ein schickes T-Shirt wie dieses!

Diese Schönheit eines T-Shirts bekommst du nach Abschluss des Hacktoberfestes (Credit: @mahsinger on Twitter)

Etiketten, Etiketten, Etiketten

Das Hacktoberfest war ein großartiger Monat, um in Open Source einzusteigen. GitHub war mit Problemen gefüllt, die als Hacktoberfest bezeichnet wurden und Ihre Hilfe brauchten. Es gab genügend Projekte zur Auswahl - von Dokumentation über Python bis hin zu RUST. In dieser Zeit habe ich gelernt, wie ich GitHub nach Labels durchsuchen und gute Themen finden kann, zu denen ich beitragen kann.

Für Leute wie mich, die keine Erfahrung hatten, erwiesen sich Labels wie First-Timer-Only, Easy oder Good-First-Issue als mein Freund. Es gibt auch einige gute Websites, die das Auffinden dieser Probleme erleichtern sollen. Zum Beispiel up-for-grabs.net oder Code-Triage - es gibt wahrscheinlich noch viel mehr.

Machen Sie mit und melden Sie sich bei ein paar davon an oder sehen Sie sich deren Probleme an!

Lernen, wie man einen Beitrag leistet

Als ich versuchte, meine ersten Beiträge zu verfassen, stellte ich fest, dass mein größtes Unbekanntes darin bestand, keine Links zum Markieren oder Gestalten einer Seite hinzuzufügen. Aber wie macht man eine gute Pull-Anfrage mit Git und der Kommandozeile.

Ich fand den kostenlosen Leitfaden von Kent C. Dodds auf egghead.io hilfreich und machte mir Notizen zu den Kommandozeilenbefehlen, die ich ausgeführt hatte, während ich folgte.

Die Anweisungen könnten zu etwas so Einfachem zusammengefasst werden:

// Zuerst müssen Sie ein Repository finden, zu dem Sie beitragen möchten, und es verzweigen!
// Dann musst du das gegabelte Repo klonen
 git clone git@github.com: Ihr Benutzername / contributing-repo.git
// Ändere dein Verzeichnis auf das neue Repo, das du geklont hast
 cd beitrag repo
// Setze das Upstream-Repository auf das ursprüngliche Repository (nicht das, das du gerade geklont hast)
 git remote add upstream git@github.com: der-besitzer-benutzername / contributing-repo.git
// Aktualisiere alle Änderungen
 Git holen stromaufwärts
// Setzen Sie unseren Master-Zweig auf den gleichen Wert wie den Upstream-Zweig
Git-Zweig --set-upstream-to = Upstream / Master Master
// Erstelle deine eigene neue Filiale für deine Pull-Anfrage
Git Checkout -b pr / mein-neuer-cooler-Beitrag
// Nehmen Sie die gewünschten Änderungen in Ihrem bevorzugten Texteditor vor und speichern Sie sie
// Status prüfen (sollte die geänderten Dateien anzeigen)
Git Status
// Änderungen betrachten und Arbeit neu bewerten
Git Diff
// füge alle Änderungen zu deinem Staging-Bereich hinzu (. für alle Dateien)
Git hinzufügen
// Alle Änderungen festschreiben und eine Nachricht für den Betreuer des Repos hinzufügen
git commit -m "Ich habe diesen coolen Text zu deinem Guide-Repository hinzugefügt."
// Push to Source Repo und Pull Request erstellen
Git-Push-Ursprung pr / my-new-cool-Beitrag

Dies hat mir wirklich geholfen, den Zweck einer Pull-Anfrage zu verstehen und den Prozess der Einreichung eines Beitrags zu verstehen. Dieser Blog-Beitrag hat mir auch geholfen zu verstehen, dass es Ihre beste Waffe ist, beschreibend zu sein. Auf diese Weise können Sie Unterstützung erhalten und angeben, ob eine Pull-Anforderung noch nicht abgeschlossen ist. Nicht lange danach leistete ich einen weiteren Übungsbeitrag, aber um ein T-Shirt zu erhalten, musste ich mein Spiel verbessern und zwei weitere Probleme finden.

Ein Match made in heaven - ein Beitrag zu freeCodeCamp-Guides

Ich habe eines Tages das Medium geöffnet und festgestellt, dass Quincy Larson eine vollständige Anleitung zur Verfügung gestellt hat, wie Leute auf einfache Weise zum freeCodeCamp-Leitfaden-Repository beitragen können. Eine Quelle gemeinsamen Wissens in den Bereichen Entwicklung, Produkt, Design und Data Science. Der Beitrag zu diesem Repository war nicht nur sehr erwünscht, sondern auch sehr einfach. Sie könnten die Beiträge in Ihrem Browser machen.

Es war nicht schwer, ein Thema zu finden, da das Handbuch-Repository alles von Barrierefreiheit über HTML bis hin zur Spieleentwicklung abdeckte.

Was mich am meisten faszinierte, war, wie einfach freeCodeCamp es machte, Neulingen wie mir einen sinnvollen Beitrag zu leisten. Wissen mit anderen teilen.

Sie haben immer noch gelernt, Pull-Requests zu stellen, Ihren Beitrag zusammenzuführen und Standards und Richtlinien einzuhalten. Der Prozess war etwas weniger einschüchternd. Es war perfekt für einen Anfänger. Tatsächlich war es so rationalisiert, dass freeCodeCamp es geschafft hat, ein GIF darüber zu erstellen, das den Prozess zusammenfasst:

Gutschrift: freeCodeCamp - Beitrag zum freeCodeCamp Leitfaden-Repository

Nach einiger Überlegung habe ich beschlossen, einen kleinen Beitrag zu verschiedenen Linux-Distributionen zu leisten. Und schreibe einen völlig neuen Abschnitt über Spieleentwicklung, um meine vier Pull-Anfragen zu erfüllen. Ich habe im Rahmen meiner Dissertation über den Sommer ein Spiel gemacht. Das Schreiben über Spieleentwicklung und Tools schien eine gute Möglichkeit zu sein, mein neu erworbenes Wissen mit anderen zu teilen.

FreeCodeCamp hat in seinen Contributing.md-Richtlinien eine Menge Details und eine Möglichkeit angegeben, um sicherzustellen, dass Sie präzise schreiben. Ich habe alle meine Nachforschungen angestellt, sie mit Quellen belegt und über die Hemingway-App gestartet. Aktive Stimme und kurze Sätze für den Sieg!

Ich machte meine Pull-Anfrage und war überglücklich, als sie verschmolzen wurde. Das ermutigende Feedback war auch ein großes Plus für die freeCodeCamp-Community.

Pull Request für den Bereich Spieleentwicklung, den ich für freeCodeCamp-Anleitungen geschrieben habe

Was können wir daraus machen?

Ich rate Ihnen, sich von der Annahme zu befreien, dass Sie beim ersten Mal perfekten und abgerundeten Code beisteuern müssen. Ihr erster Beitrag muss nicht bahnbrechend sein (oder sogar Code, um genau zu sein).

Projektbetreuer wissen, dass dies möglicherweise Ihr erster Open Source-Beitrag ist, wenn sie das Problem als "nur für Erstanwender" oder ähnlich gekennzeichnet haben. Ihr Beitrag kann so etwas wie das Korrigieren eines Rechtschreibfehlers, das Hinzufügen von Hyperlinks oder ein kleines Lernprojekt sein. Fangen Sie klein an, um sich mit dem Prozess vertraut zu machen.

Viele Projektbetreuer, die ihre Probleme als anfängerfreundlich bezeichnen, beantworten gerne Ihre Fragen und bieten Unterstützung an. Scheuen Sie sich also nicht, um Klärung zu bitten, wenn Sie etwas nicht verstehen.

Als das Hacktoberfest-T-Shirt Mitte Dezember endlich aus Amerika ankam, hatte ich das Gefühl, Weihnachten sei früh angebrochen. Wenn ich es in meinen Händen hielt, wurde mir klar, dass ich geholfen hatte, etwas Wichtiges zu schaffen und zu erweitern. Ein Gefühl, von dem ich glaube, dass viele Leute, die regelmäßig zu Open Source beitragen, es erleben werden. Wenn ich es trage, erinnere ich mich immer daran, mein Wissen zu teilen, und dieses Jahr werde ich auch versuchen, den Sprung zu wagen, um mehr Code beizutragen, schließlich bin ich kein Anfänger mehr!