Как принять участие в Hacktoberfest – даже если вы не пишете код

1655995699 kak prinyat uchastie v hacktoberfest – dazhe esli vy ne

Hacktoberfest — это мероприятие, организованное DigitalOcean, сотрудничающее со многими организациями. Цель состоит в том, чтобы вернуть и внести свой вклад в проекты с открытым кодом. Организаторы предлагают небольшие поощрения за хорошо проделанную работу, например рубашку и наклейки.

Другие организации также участвуют, предлагая свои вознаграждения. Вы можете найти список организаций, созданных сообществом, предлагающих стимулы для участия в Hacktoberfest Swag.

Только значимые взносы будут относиться к общему количеству 4 необходимых. Не спешите и проявляйте всеобщую вежливость с сопровождающими, чтобы обеспечить объединение ваших запросов на подъемник. Подробнее об этом см. ниже.

Как принять участие в Hacktoberfest

Важно отметить, что Hacktoberfest предназначен для приготовления любого. качество вклад в проекты с открытым кодом Никто не сказал, что это должен быть код!

Каждый способен что-то выдвинуть:

  • Авторы
  • Художники
  • Разработчики программного обеспечения
  • Технические писатели
  • Переводчики

Я не собираюсь явно перечислять хранилища для внесения кода, потому что их достаточно легко найти. Все хранилища, перечисленные по приведенным ниже ссылкам, приняли участие в Hacktoberfest.

  • GitLab (Все репозитории с темой hacktoberfest на GitLab.)
  • GitHub (Все хранилища с темой hacktoberfest на GitHub.)

Ниже приведены проекты, которые я рекомендую, если вы не знаете, как кодировать, но все равно хотите внести вклад в проекты с открытым кодом (или Creative Commons). Он включает только проекты, вручную принявшие участие в Hacktoberfest.

Вам не нужно знать язык программирования или HTML, чтобы внести свой вклад в них. Ожидается, что вы будете знать, как выполнять свою работу с Git, о чем мы расскажем позже.

ст

Проекты, требующие искусства или анимации:

Великолепные списки

Списки ресурсов, поддерживаемых сообществом:

Книги

Бесплатные электронные книги поддерживаются с использованием подхода «документы как код»:

Конфигурация

Проекты, вращающиеся вокруг конфигурационных файлов. Вклад может быть просто добавлением записи в файл JSON:

Документация

Проекты, где нужно просто вводить текст на простом английском. Программирование и технические знания помогут, но специальные навыки не требуются.

Это включает только хранилища, которые хранят документацию в формате, который был бы простым для большинства пользователей, таких как Markdown.

Переводы

Проекты, требующие перевода текста с английского на другие языки.

Проекты, использующие платформы для массового перевода, такие как Weblate, не включены сюда, поскольку переводчик не создает запрос на подъемник. К сожалению, Hacktoberfest рассматривает только того, кто открыл запрос на подъемник, а не авторов изменений.

Убедитесь, что вы предоставляете только переводы, проверенные человеком, то есть переведенные человеком или машинный перевод, но проверенный человеком. Опять же важное качество.

Разное

Уникальные проекты:

Давайте не превращать это в Spamtoberfest

К сожалению, Хактоберфест получил несколько плохую репутацию среди некоторых проектов из-за спама. Иногда авторы могут немного стремиться завершить Hacktoberfest и упустить суть. ^-^’

С 2020 года, если пользователь делает 2 запроса на подъемник, которым назначается метка со словом spam или invalid в нем участнику будет запрещено посещать Хактоберфест на неопределенный срок, включая предстоящие события.

Mindustry справляется с этим лучше всего, по моему мнению, из Hacktoberfest Hall of Shame.

Начиная с 2021 года Hacktoberfest делает больше для борьбы со спамом, исключая проекты, поощряющие тянуть запросы без всякой ценности.

изображение-8
Цель возвращения к открытому коду будет взорвана, если большинство взносов просто пойдет на «Полный Хактоберфест!» хранилища.

Как внести ценный вклад в Hacktoberfest

  • У вас есть месяц, чтобы сделать 4 запроса на подъемник. Используй это! Вероятно, они будут объединены, если вы делаете меньше качественных запросов на подъемник.
  • Не думайте, что каждый ваш запрос будет объединен до завершения Hacktoberfest. Попытайтесь сделать более 4, если можете!

Упражняйте обычную вежливость

Сопроводители с открытым кодом тоже имеют жизнь. У них не всегда есть время просмотреть все запросы на подъемник, особенно в конце Хактоберфеста.

Не заставляйте сопровождающих чувствовать себя плохо, не торопитесь и не требуйте внимания. Просто поработайте над чем-нибудь другим, если они заняты.

Как поручить работу и открыть запрос на подъемник

Теперь, когда вы знаете, как быть полезным участником Hacktoberfest, и вы узнали некоторые проекты, в которые также сможете внести свой вклад, остается только научиться делать вклад.

И GitHub, и GitLab дают способы упростить внесение небольших изменений. Мы не собираемся их использовать, потому что будет проще показать единственный набор инструкций, которые будут работать везде, а не полагаться на особенности платформы.

Перед продолжением выберите репозиторий, в который вы хотите внести вклад. Если вы многоязычны, то tldr-страницы будут самыми простыми, иначе рассмотрите бесплатные книги по программированию.

В своих примерах я собираюсь использовать бесплатные учебники по программированию.

Как установить Git

Сначала вам следует установить Git, являющийся системой контроля версий. Это инструмент, который проекты используют для управления изменениями.

Пользователи Windows могут загрузить его с веб-сайта git-scm. Пользователи Linux могут его установить с помощью желаемого менеджера пакетов.

После установки Git убедитесь, что он правильно установлен с помощью git --version.

Теперь настройте имя и адрес электронной почты. Имя не имеет значения, но вы должны указать тот же адрес электронной почты, который вы используете для Hacktoberfest.

git config --global user.name "Your Name"
git config --global user.email "your@email.org"

Обратите внимание, что адрес электронной почты, который вы укажете здесь, будет считаться общедоступной информацией после того, как ваш запрос на удаление будет объединен. Кто-либо может просмотреть детали комита, содержащего сведения об авторе.

Например, мой адрес электронной почты отображается при выводе, когда я это сделаю git log на одном из моих комиттов.

commit 9647912b202a57474b4cd0ce796126c462c1ecc0 (HEAD -> added-react-book, develop/added-react-book)
Author: Seth Falco <seth@falco.fun>
Date:   Tue Oct 5 14:04:25 2021 +0200

    added a react book from digitalocean

Если это проблема, и GitHub, и GitLab обеспечивают функцию сокрытия вашего электронного адреса, предоставляя вам одноразовую. Вы можете включить эту функцию и использовать этот адрес электронной почты git config вместо этого.

Как разделить и клонировать репозиторий

Далее вы хотите разделить репозиторий. Вам не будет позволено вносить изменения непосредственно в хранилище, поэтому вместо этого вы создадите форк, являющийся копией проекта, находящегося под вашим контролем.

изображение-10
Кнопка «Вилка» находится в правом верхнем углу страницы хранилища.

Далее клонируйте хранилище локально. Это перетягивает копию всего в репозитории на вашу машину, чтобы вы могли начать работать над ней.

Мы сделаем это в терминале. Если вы используете Windows, вы можете использовать командную строку или PowerShell.

Перейдите в соответствующее место в вашей файловой системе, например ваш Downloads или Documents каталога, а затем выполните следующее:

  • Клонируйте хранилище, над которым хотите работать.
  • Введите каталог в терминале.
  • Свяжите репозиторий с форком в вашем аккаунте.
git clone 
cd free-programming-books
git remote add develop https://github.com/{YOUR_USERNAME}/free-programming-books.md

Как работать с проектом

Теперь когда вы клонировали хранилище локально, вы можете начать с ним работать. В большинстве хранилищ лучше всего открывать их в редакторе кода, например Visual Studio Code, но технически вы можете работать с любым текстовым редактором, включая Блокнот.

Откройте каталог, содержащий клонированный репозиторий в своем редакторе. По умолчанию он назван по названию хранилища, например теперь у меня есть папка с именем free-programming-books.

Теперь вы можете вносить изменения:

  • Если вы не уверены, что делать, проверьте, нужно ли что-нибудь конкретное, просмотрев вкладку «Проблемы» в хранилище.
  • Как вариант, сделайте что угодно значимым изменить ты хочешь.

С бесплатными книгами по программированию это хранилище для поддержки списка бесплатных электронных книг, поэтому мы можем добавить в него больше ресурсов.

DigitalOcean имеет несколько замечательных книг в разделе сообщества своего веб-сайта, поэтому мы можем просто добавить одну или несколько из них в хранилище. Для этого примера я выбрал кодирование в React.js.

Я могу перейти к соответствующему разделу в проекте books/free-programming-books-langs.md файл и добавьте ресурс под файлом React раздел документа.

Добавленная строка выглядит так:

* [How To Code in React.js]( - Joe Morgan
* [Resource Title](URL to Resource) - Author Name

Как поручить свою работу

Теперь, когда вы внесли изменения, вам захочется взять на себя обязательство и продолжить работу.

Вы только внесли изменения локально пока – теперь мы хотим отправить запрос на подъемник. В основном это означает, что вы отправите запрос с просьбой к сопровождающему репозитарию включить ваши изменения в свое хранилище.

В вашем терминале мы выполним следующие действия:

  • Создайте новую ветвь.
  • Скажите Git, что вы хотите сохранить все изменения.
  • Зафиксируйте изменение с помощью сообщения с описанием того, что вы сделали.
  • Внесите изменения в вилку.
git checkout -b added-react-book
git add .
git commit -m "added a react book from digitalocean"
git push develop added-react-book

Надеемся, это должно дать следующий результат:

Enumerating objects: 7, done.
Counting objects: 100% (7/7), done.
Delta compression using up to 8 threads
Compressing objects: 100% (4/4), done.
Writing objects: 100% (4/4), 1.07 KiB | 1.07 MiB/s, done.
Total 4 (delta 3), reused 0 (delta 0)
remote: Resolving deltas: 100% (3/3), completed with 3 local objects.
remote: 
remote: Create a pull request for 'added-react-book' on GitHub by visiting:
remote:      
remote: 
To github.com:SethFalco/free-programming-books.git
 * [new branch]        added-react-book -> added-react-book
Щелчок переведет вас на страницу запроса на подъемник.

Как создать запрос на подъемник

И GitHub, и GitLab сбросят ссылку в выводе команды выше, которая позволит открыть запрос на подъемник.

Если вы нажмете эту ссылку (возможно, вам придется удерживать CTRL), это переведет вас на страницу, где вы можете предоставить больше информации и отправить запрос на выписку.

изображение-11

Просто введите данные и нажмите кнопку «Создать запрос на подъемник». Все, что осталось, это дождаться, пока сопровождающие пересмотрят это.

Очистите код

Как только вы завершили запрос на подъемник, вы должны оставить свою ветвь и вернуться к основной ветви репозитория.

Выполните следующие команды в своем терминале:

  • Проверьте, есть ли первичная ветвь main или master.
  • Перейдите к основной ветви хранилища.
  • Обновите локальную копию, чтобы она была синхронизирована с хранилищем.
git branch
git checkout main
git pull
Проверьте выход git branch чтобы определить, следует ли использовать main или master.

Перезапустите шаг «Как работать с проектом», чтобы внести больше изменений.

Вывод

Я надеюсь, что это даст больше информации о Hacktoberfest, и вы чувствуете себя увереннее, участвуя в сообществе с открытым кодом, даже если вы не пишете программное обеспечение.

Удачи с вашими запросами на подъемник!

Добавить комментарий

Ваш адрес email не будет опубликован.