Mein erstes Hacktoberfest - Erfahrungen mit dem Beitrag zu Open Source als Erstbesucher

Ein Beitrag zu Open Source und Projekten kann ein entmutigender Prozess sein. Ihre bevorzugte Suchmaschine gibt eine Menge Ergebnisse in Handbüchern und Repositories zurück, um loszulegen. Aber oft liefert Ihre Suche nicht das gewünschte Ergebnis. Sie wissen immer noch nicht, wie Sie zu Open Source beitragen können, selbst nachdem Sie mehrere Blog-Beiträge gelesen haben. Die Beeinträchtigung des Ansehens bestimmter Projekte und ein harter Unterton helfen ebenfalls nicht und könnten die Sache noch komplizierter machen.

Ich war selbst dort. Ich durchsuchte Seiten, um großartige Open Source-Repositories zu finden, zu denen ich beitragen konnte, nur um festzustellen, dass ich nicht wusste, wie ich anfangen sollte.

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

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

Das Hacktoberfest war ganz anders.

Was genau ist ein Hacktoberfest?

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

Das Hacktoberfest ist eine einmonatige Feier, die vom 1. bis 31. Oktober zu Open Source beiträgt. Es wurde von DigitalOcean in Zusammenarbeit mit GitHub initiiert. Im Oktober werden Sie aufgefordert, Beiträge zu leisten und Pull-Anfragen an Ihre bevorzugten Repositories auf GitHub zu richten. Wenn Sie es schaffen, insgesamt vier zu machen, sind Sie berechtigt, ein schickes T-Shirt wie dieses zu erhalten!

Diese Schönheit eines T-Shirts erhalten Sie nach Abschluss des Hacktoberfestes (Bildnachweis: @mahsinger auf Twitter)

Etiketten, Etiketten, Etiketten

Das Hacktoberfest war ein großartiger Monat, um in Open Source einzusteigen. GitHub war voller Probleme mit dem Hacktoberfest, die Ihre Hilfe brauchten. Es gab genügend Projekte zur Auswahl - von Dokumentation über Python bis hin zu RUST. Während dieser Zeit habe ich gelernt, wie man GitHub nach Labels nach Problemen durchsucht und wie man gute Probleme findet, zu denen man beitragen kann.

Für Leute wie mich, die keine Erfahrung hatten, erwiesen sich Labels wie "Nur für Anfänger", "Einfach" oder "Gut, Erstausgabe" 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.

Melden Sie sich bei einigen an oder sehen Sie sich deren Probleme an!

Lernen, wie man einen Beitrag leistet

Beim Versuch, meine ersten Beiträge zu leisten, stellte ich fest, dass mein größtes Unbekanntes nicht darin bestand, Links zum Markdown hinzuzufügen oder eine Seite zu gestalten. Aber wie man eine gute Pull-Anfrage mit git und der Kommandozeile macht.

Ich fand den kostenlosen Leitfaden von Kent C. Dodds auf egghead.io hilfreich und machte mir Notizen zu den Befehlszeilenbefehlen, die ich ausgeführt habe, während ich ihnen gefolgt bin.

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

// Zuerst müssen Sie ein Repository finden, zu dem Sie beitragen möchten, und es teilen! 
// Dann müssen Sie den gegabelten Repo-Git-Klon git@github.com klonen: Ihr Benutzername / Contributing-Repo.git
// Ändere dein Verzeichnis in das neue Repo, das du geklont hast
// Setze das Upstream-Repository auf das ursprüngliche Repository (nicht das, das du gerade geklont hast)
// Aktualisiere alle Änderungen git fetch upstream
// Setze unseren Master-Zweig auf den gleichen wie den Upstream-Zweig git branch --set-upstream-to = Upstream / Master-Master
// Erstelle deinen eigenen neuen Zweig für deine Pull-Anfrage git checkout -b pr / my-new-cool-Contribution
// Nehmen Sie Änderungen in Ihrem bevorzugten Texteditor vor und speichern Sie diese
// Status überprüfen (sollte die geänderten Dateien anzeigen) Git-Status
// Änderungen betrachten und Arbeit git diff neu bewerten
// füge alle Änderungen zu deinem Staging-Bereich hinzu (. für alle Dateien) git add 
// Übernehmen Sie alle Änderungen und fügen Sie eine Nachricht für den Betreuer des Repo-Git-Commits -m hinzu. "Ich habe diesen coolen Text zu Ihrem Guide-Repository hinzugefügt."
// Push to Source Repo und erstelle Pull Request Git Push Origin Pr / My-New-Cool-Contribution

Dies hat mir wirklich geholfen, den Zweck einer Pull-Anfrage zu verstehen und den Prozess des 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 noch eine Pull-Anfrage ausgeführt wird. 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-Anleitungen

Ich habe eines Tages Medium geöffnet und festgestellt, dass Quincy Larson einen vollständigen Leitfaden zur Verfügung gestellt hat, wie Benutzer problemlos zum freeCodeCamp-Leitfaden-Repository beitragen können. Eine Quelle für gemeinsames Wissen in den Bereichen Entwicklung, Produkt, Design und Datenwissenschaft. Der Beitrag zu diesem Repository war nicht nur sehr ermutigt, sondern auch sehr einfach. Sie können die Beiträge in Ihrem Browser leisten.

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 den Prozess machte, damit Neulinge wie ich einen bedeutenden Beitrag leisten können. Wissen mit anderen teilen.

Sie haben immer noch gelernt, wie Sie Pull-Anfragen stellen, Ihren Beitrag zusammenführen und Standards und Richtlinien einhalten können. Der Prozess war etwas weniger einschüchternd. Es war perfekt für einen Anfänger. In der Tat war es so rationalisiert, dass freeCodeCamp es geschafft hat, ein GIF darüber zu erstellen, das den Prozess zusammenfasst:

Credit: freeCodeCamp - Beitrag zum Repository von freeCodeCamp Guides

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 Sommer im Rahmen meines Dissertationsprojekts ein Spiel gemacht. Das Schreiben über Spieleentwicklung und Tools schien eine gute Möglichkeit zu sein, mein neu erworbenes Wissen mit anderen zu teilen.

In den Contributing.md-Richtlinien hatte freeCodeCamp viele Details und eine Möglichkeit angegeben, um sicherzustellen, dass Ihr Schreiben präzise war. Ich habe alle meine Nachforschungen angestellt, sie mit Quellen gesichert und über die Hemingway-App ausgelöst. Aktive Stimme und kurze Sätze für den Sieg!

Ich machte meine Pull-Anfrage und war überglücklich, als es zusammengeführt wurde. Das ermutigende Feedback war auch ein großes Plus der freeCodeCamp-Community.

Pull Request für den Abschnitt Game Development, den ich für freeCodeCamp-Anleitungen geschrieben habe

Was können wir daraus machen?

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

Projektbetreuer wissen, dass dies möglicherweise Ihr erster Open Source-Beitrag ist, wenn sie das Problem als "Nur für Erstanfänger" 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 auch gerne Ihre Fragen und bieten Unterstützung. Seien Sie also nicht schüchtern, um Klarstellung zu bitten, wenn Sie etwas nicht verstehen.

Als das Hacktoberfest-T-Shirt Mitte Dezember endlich ankam und aus Amerika verschifft wurde, hatte ich das Gefühl, dass Weihnachten früh gekommen war. Wenn ich es in meinen Händen hielt, wurde mir klar, dass ich geholfen hatte, etwas zu schaffen und zu erweitern, das wichtig war. Ich glaube, dass viele Menschen, die regelmäßig zu Open Source beitragen, das Gefühl haben werden. Das Tragen erinnert 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!