Понять, где вы можете помочь

Завершено

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

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

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

Поиск проекта с открытым исходным кодом, в котором можно поучаствовать

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

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

Совет

Один важный совет: все виды вкладов ценны. Ваш опыт или знание проекта не имеют значения. У нас всех есть что-то, что мы можем внести. Будьте уверены в себе. Здесь важнее всего желание помочь.

Вы также можете использовать поиск GitHub для просмотра разделов и связанных с ними проектов. Перейдите к поиску GitHub и введите слово темы.

Предположим, вы заинтересованы в машинном обучении.

Снимок экрана: разделы поиска GitHub.

Затем вы можете сузить поиск, выбрав разделы на левой боковой панели.

Снимок экрана: результаты узкого поиска GitHub.

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

Ознакомление с проектом с открытым кодом

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

В большинстве проектов эти документы будут находиться на верхнем уровне репозитория.

  • ЛИЦЕНЗИЯ: Проект должен содержать лицензию с открытым кодом. Если у проекта нет лицензии, это не проект с открытым кодом.
  • README: Файл README обычно служит в качестве страницы приветствия для проекта. Обычно он содержит сведения о том, как приступить к работе с проектом. Кроме того, он часто добавляет сведения о том, как примкнуть к сообществу.
  • УЧАСТИЕ: Как предполагает его название, в этом документе содержатся рекомендации по тому, как внести свой вклад в проект. Обычно в нем описывается, как работает процесс участия в проекте, и содержатся сведения о настройке среды разработки.
  • CODE_OF_CONDUCT: В кодексе поведения устанавливаются правила для членов сообщества. Это позволяет сделать сообщество безопасной и дружелюбной средой для всех.

Хотя не все проекты содержат документы CONTRIBUTING или CODE OF CONDUCT, наличие этих документов является хорошим знаком, что проект дружелюбный и открытый.

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

  • Средство отслеживания проблем: Где люди обсуждают вопросы и задачи, связанные с проектом. Чтобы найти проблемы в GitHub, перейдите на главную страницу репозитория на сайте GitHub и добавьте /issues в конец URL-адреса (например, https://github.com/jupyter/notebook/issues).
  • Пулл-реквест: Где люди обсуждают и проверяют изменения в проекте. Его можно найти в GitHub, добавив pulls в URL-адрес проекта (например, https://github.com/jupyter/notebook/pulls).
  • Каналы чата и форумы: В некоторых проектах используются каналы чата, такие как Slack, Gitter и IRC, или форумы, такие как Дискурс для бесед и обсуждений.

Определение задач для работы

Вы нашли проект, прочитали руководства по участию в проекте и теперь готовы поучаствовать в работе над ним.

Возможно, вы уже определили поле для работы, например исправление неработающих ссылок или обновление документов. Хорошим способом поиска понятных для начинающих проблем, в которых вы можете помочь, является посещение URL-адреса /contribute проекта (например, https://github.com/jupyter/notebook/contribute).

Снимок экрана: раздел

Вы заметите, что большинство проблем, отображаемых в URL-адресе contribute, будут иметь метки, такие как good-first-issue, help wanted, beginner-friendly и т. д. Метки часто используются для предоставления сведений о самом верхнем уровне проблемы и требуемой помощи.

Можно перейти на страницу меток, например https://github.com/jupyter/notebook/labels. Затем подберите проблемы с метками, такими как help wanted, discussion или другими соответствующими метками, к типу интересующего вас вклада.

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

Снимок экрана: pull request, связанный с задачей.

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

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

Если проект имеет право на спонсорство через спонсоров GitHub, вы найдете кнопку "Спонсор " на главной странице проекта.

Снимок экрана: поле спонсирования на странице проекта GitHub.

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

Снимок экрана: уровни спонсорства.

Обзор урока

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

Ниже приведен удобный контрольный список, который можно использовать при взаимодействии с проектом в первый раз:

  • Есть ли лицензия?
  • Существуют ли проблемы и обсуждения с запросами на включение внесенных изменений, активно используемые авторами и участниками?
  • Использует ли проект такие метки, как help wanted или good first issue для новичков?
  • Имеет ли проект кодекс поведения?
  • Имеет ли проект четкие рекомендации по участию?

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