Визначення місця, де можна допомогти
У цій одиниці ми обговоримо, як можна почати роботу з внесками з відкритим кодом. Крім того, ми використовуватимемо проблеми та позначки, щоб знаходити завдання для участі.
програмне забезпечення з відкритим кодом може вільно використовувати, змінювати та спільно використовувати будь-хто. Використовуючи програмне забезпечення з відкритим кодом, будь-хто може переглядати, змінювати та розповсюджувати проект для будь-яких цілей. Ідея програмного забезпечення з відкритим кодом полягає в тому, що код спільного доступу призводить до кращого, надійнішого програмного забезпечення.
Існує багато способів внести свій внесок у проекти з відкритим кодом. Зробити свій перший внесок часто може бути страшний досвід, але це не повинно бути. Відкрите джерело – це місце для всіх користувачів, і внески відбуваються на всіх рівнях.
Пошук проекту з відкритим кодом, який потребує внесків
Ви можете почати роботу, замислюючись про проекти, які ви вже використовуєте, або хочете використовувати їх. Зробити внесок простіше, коли ви знайомі з проектом і його спільнотою.
Можливо, під час читання файлу README проекту ви знайдете недійсне посилання або деякі друкарські повідомлення. Можливо, ви помітили, що щось не працює належним чином, або документація застаріла. Це всі великі можливості, щоб допомогти і внести свій внесок у проект.
Кінчик
Одна важлива порада: Всі види внесків цінні. Ваш рівень досвіду або знання проекту тут не має значення. У всіх нас є те, що ми можемо внести свій внесок. Будьте впевнені в собі. Найголовніше, що тут є воля, щоб допомогти.
Використання пошуку GitHub
Ви також можете використовувати пошук GitHub для вивчення тем і пов'язаних проектів. Перейдіть до пошуку GitHub і введіть своє тематичне слово.
Скажімо, ви зацікавлені в машинне навчання.
Потім можна звузити пошук, вибравши Розділи на лівій бічній панелі.
Тут можна знайти репозиторії, які стосуються ключового слова пошуку та репозиторіїв, які курували учасники спільноти.
Знайомство з проектом із відкритим кодом
Тут варто згадати, що кожна спільнота з відкритим кодом відрізняється. Знайшовши проект, потрібно ознайомитися з проектом і рекомендаціями щодо його участі.
Більшість проектів міститимуть такі документи на верхньому рівні сховища:
- LICENSE: Проект має містити ліцензію з відкритим кодом. Якщо проект не має ліцензії, це не відкрите джерело.
- README: Файл README зазвичай слугує сторінкою привітання проекту. Зазвичай він надає відомості про те, як почати роботу з проектом. Крім того, часто додається інформація про те, як взаємодіяти зі спільнотою.
- ВНЕСОК: Як випливає з назви, у цьому документі наведено вказівки щодо того, як внести свій внесок у проект. Зазвичай він описує, як працює процес внеску, і містить відомості про те, як налаштувати середовище розробки.
- CODE_OF_CONDUCT: Правила поведінки встановлюють наземні правила для учасників спільноти. Таким чином, це допомагає зробити спільноту безпечним і привітним середовищем для всіх.
Хоча не всі проекти мають документи, що надають внески або 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або іншими етикетками, які відповідають типу внеску, у який вас цікавить.
Досліджуйте проблеми, ви також можете помітити, що деякі з них пов'язані з іншими проблемами або запитами на витяг.
Спонсор проекту
Існує багато способів зробити свій внесок у відкритий вихідний код. Ви можете фінансово підтримувати людей, які будують і підтримують екосистему з відкритим кодом за допомогою коду, лідерства, наставництва, дизайну та за його межами.
Відкрите джерело значною мірою залежить від волонтерської роботи. Спонсори GitHub дозволяють фінансувати проекти та приватних осіб, щоб допомогти їм продовжувати виконувати свою роботу з відкритим кодом, надаючи їм визнання, на які вони заслуговують.
Якщо проект має право на спонсорство через спонсорів GitHub, ви знайдете кнопку Спонсора на головній сторінці проекту.
Ви можете вибрати рівень спонсорства та зробити свій внесок загальнодоступним.
Повторення одиниці вимірювання
У цій одиниці ви дізналися, як почати роботу з відкритим вихідним внеском. Тепер ви знаєте, як вибрати проект для роботи та використовувати проблеми та підписи GitHub для визначення завдань для роботи.
Нижче наведено зручний контрольний список, який використовуватиметься під час першої взаємодії з проектом.
- Чи має вона ліцензію?
- Проблеми та обговорення запитів, які активно використовують супроводжувачі та співавтори?
- Чи використовуються в проекті такі підписи, як
help wantedабоgood first issueдля новачків? - Чи є у проекту кодекс поведінки?
- Чи має проект чіткі рекомендації щодо внесків?
Нарешті, пам'ятайте, що всі внески вітаються, і екосистема з відкритим кодом значно отримує вигоду від ваших ідей та участі. Існує багато способів зробити свій внесок у відкритий код, від надсилання коду або участі в обговореннях проектів до спонсорів проектів за допомогою спонсорів GitHub.