от 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. Его ношение всегда напоминает мне о необходимости поделиться своими знаниями, и в этом году я также попробую совершить прыжок, чтобы добавить больше кода, в конце концов, я уже не новичок!