
Содержание статьи
от Sibylle Sehl

Вклад в Open Source и проекты могут показаться сложным процессом. Ваша любимая поисковая система вернет массу результатов в руководствах и репозиториях, чтобы начать. Но часто ваш поиск не дает желаемого результата, вы все еще не знаете, как внести свой вклад в Open Source, даже прочитав несколько публикаций в блоге. Угроза репутации некоторых проектов и резкий подтекст также не помогают и могут еще больше усложнить ситуацию.
Я был там. Я просматривал страницы, чтобы найти отличные репозитории с открытым кодом, чтобы внести свой вклад, но заметил, что не знал, с чего начать.
Разочарованный и немного разочарованный, я начал сосредотачиваться на других проектах.
Но все изменилось, когда я увидел наклейку Hacktoberfest одного из сотрудников на их ноутбуке. Я был заинтригован — это ли не пережиток очередного хакатона?
Хактоберфест оказался совсем другим.
Итак, что такое Хактоберфест?
Подсказка: это не связано ни с пивом, ни с хакерством, ни с Октоберфестом (который действительно происходит в сентябре, ага!).
Hacktoberfest — это месячный праздник взноса в Open Source, который проходит с 1 по 31 октября. Он был инициирован DigitalOcean в сотрудничестве с GitHub. В течение октября вас поощряют вносить взносы и посылать запросы на получение ваших любимых репозиториев на GitHub. Если вам удастся сделать всего четыре, вы вправе получить такую шикарную футболку!

Ярлыки, ярлыки, ярлыки
Хактоберфест оказался отличным месяцем для изучения открытого кода. GitHub был заполнен проблемами с метками Хактоберфест что нуждалась в вашей помощи. На выбор было достаточно проектов – от документации до Python и RUST. За это время я научился искать проблемы на GitHub за этикетки и как найти хорошие проблемы, чтобы внести свой вклад.
Для таких людей, как я, не имевших никакого опыта, такие этикетки, как только для новичков, легко или хороший-первый-выпуск оказался моим другом. Есть также несколько хороших веб-сайтов, упрощающих процесс поиска этих проблем. Например, up-for-grabs.net или code-triage – наверное, их гораздо больше.
Подпишитесь на несколько или просмотрите их проблемы!
Обучение вносить вклад
Пытаясь сделать свои первые взносы, я понял, что мое самое неизвестное заключается не в том, как добавить ссылку к разметке или стилизовать страницу. Но как сделать a хорошо запрос на получение с помощью git и командной строки.
Я нашел бесплатное руководство Кента С. Доддса на egghead.io полезным и сделал заметки о командах командной строки, которые я выполнял, следя за текстом.
Инструкции можно подытожить так просто:
//First you need to find a repository you want to contribute to and fork it!
// Then you have to clone the forked repo git clone git@github.com:yourusername/contributing-repo.git
// Change your directory to the new repo you cloned cd contributing-repo
// Set the upstream repository to the original repository (not the one you just cloned) git remote add upstream git@github.com:the-owners-username/contributing-repo.git
// Update any changes git fetch upstream
// Set our master branch to same as upstream branchgit branch --set-upstream-to=upstream/master master
// Create your own new branch for your pull requestgit checkout -b pr/my-new-cool-contribution
// Make any changes in your favourite text editor and save
//check status (should show the modified files)git status
// look at changes and reassess workgit diff
// add any changes to your staging area ( . for all files)git add
// Commit all changes and add a message for the maintainer of the repogit commit -m "I added this cool text to your guide repository"
// Push to source repo and create pull requestgit push origin pr/my-new-cool-contribution
Это помогло мне понять цель пул-запроса и понять процесс создания вклада. Эта публикация в блоге также помогла мне понять, что описание – это ваше лучшее оружие – так вы можете получить поддержку и указать, выполняется ли запрос на вытягивание. Вскоре после этого я внес еще один тренировочный вклад, но чтобы получить футболку, мне нужно было улучшить свою игру и найти еще две проблемы.
Совпадение на небесах – вклад в пособия freeCodeCamp
Однажды я открыл Medium и увидел, что Квинси Ларссон предоставил полное руководство о том, как люди могут легко внести вклад в хранилище пособий freeCodeCamp. Источник общих знаний о разработке, продукте, дизайне и науке о данных. Внести вклад в этот репозиторий было не только очень поощренно, но и очень легко. Вы можете делать вклады в своем браузере.
Найти тему было нетрудно, поскольку репозиторий пособий охватывал все от доступности к HTML до разработки игр.
Больше всего меня заинтересовало то, как freeCodeCamp облегчил процесс, чтобы новички, как я, могли внести весомый вклад. Обмен знаниями с другими.
Вы все еще научились создавать запросы на получение, объединять ваши взносы и следовать стандартам и указаниям взносов. Процесс был несколько менее пугающим. Это было идеально для новичка. На самом деле это было настолько упрощено, что freeCodeCamp удалось создать gif об этом, который подытоживает процесс:

После некоторых размышлений я решил внести небольшой вклад в различные дистрибутивы Linux. И напишите совершенно новый раздел о разработке игр, чтобы завершить мои четыре запроса на удаление. Я создал игру летом как часть своего дипломного проекта. Писать о разработке игр и инструментах казалось хорошим способом поделиться моими недавно полученными знаниями с другими.
В своих инструкциях Contributing.md freeCodeCamp предоставил много деталей и способ убедиться, что ваш текст был лаконичным. Я провел все свои исследования, подтвердил его источниками и запустил через приложение Hemingway. Активный голос и краткие предложения для победы!
Я сделал свой запрос на вытягивание и был в восторге, когда его объединили. Ободряющие отзывы также были большим плюсом от сообщества freeCodeCamp.

Что мы можем взять из этого?
Я бы посоветовал вам освободиться от предположения, что вам нужно добавить идеальный и хорошо округленный код с первого раза. Ваш первый взнос не обязательно должен быть новаторским (или даже кодом, если быть точным).
Сопроводители проекта знают, что это может быть ваш первый взнос с открытым кодом, если они обозначили проблему как только для новичков или подобные. Ваш вклад может быть любым, например, исправлением орфографической ошибки, добавлением гиперссылок или небольшим обучающим проектом. Начните с малого, чтобы ознакомиться с процессом.
Многие сопровождающие проекты, обозначающие свои проблемы как дружественные для начинающих, также с удовольствием отвечают на ваши вопросы и оказывают поддержку. Поэтому не стесняйтесь спрашивать разъяснения, если вам что-нибудь непонятно.
Когда в середине декабря наконец-то прибыла футболка Hacktoberfest, которую доставили из Америки, я почувствовал, что Рождество наступило рано. Держа его в руках, я понял, что помог создать и расширить что-нибудь важное. Я считаю, что это чувство испытывает много людей, регулярно вносящих вклад в Open Source. Его ношение всегда напоминает мне о необходимости поделиться своими знаниями, и в этом году я также попробую совершить прыжок, чтобы добавить больше кода, в конце концов, я уже не новичок!