Посібник зі спринту

Ласкаво просимо на BeeWare Sprints!

Ласкаво просимо! Ми дуже раді, що ви вирішили приєднатися до нас! Якщо ви ще не представилися комусь із команди Bee, будь ласка, зробіть це. Після цього поверніться сюди, щоб розпочати роботу.

Що таке спринт?

Спринт — це неформальна можливість провести кілька годин або днів, спільно працюючи над проектом з відкритим кодом. Зазвичай спринти проводяться в рамках конференцій; спринт після конференції дає змогу перетворити енергію, ентузіазм та інтерес, які виникли під час конференції, на вдосконалення програмного забезпечення, яким ми користуємося щодня.

Спринти також дають можливість ознайомити людей із процесом участі в проєкті. Ми сподіваємося, що вам так сподобається брати участь у спринті, що, повернувшись додому, ви продовжите робити свій внесок!

Не має значення, скільки у вас досвіду. Під час попередніх спринтів ми об’єднували внески людей з різним рівнем досвіду — учнів старших класів, нещодавніх випускників буткемпів, людей, які не вважають себе програмістами, та досвідчених розробників. Незалежно від вашого рівня досвіду — ми знайдемо спосіб, як ви зможете долучитися до роботи.

Крім того, код — це не єдиний спосіб, яким ви можете долучитися до проекту. Такий проект, як BeeWare, — це набагато більше, ніж просто код: нам потрібні люди, які писатимуть, вичитуватимуть та перекладатимуть документацію; нам потрібні люди, які вдосконалюватимуть дизайн веб-сторінок; навіть процес перегляду багів, про які повідомляли роками тому, та перевірка того, чи були вони виправлені з того часу, є цінним внеском.

Початкові запитання

Щоб допомогти вам розпочати, ми задамо кілька запитань, щоб оцінити ваші інтереси та досвід. Це допоможе нам визначити, як саме ви зможете зробити свій внесок. Пройдіть запитання, зробіть нотатки, а потім знайдіть когось із команди Bee і поділіться своїми відповідями. Якщо ви не розумієте поставлене запитання — не хвилюйтеся! Розкажіть нам те, що ви знаєте, і ми разом розберемося з цим далі.

1. Чи користувалися ви раніше BeeWare?

Якщо ви ще цього не зробили, почніть з проходження посібника з BeeWare. У ньому ви знайдете вступну інформацію про те, що таке проєкт BeeWare та як його складові частини взаємодіють між собою. Якщо під час проходження посібника у вас виникнуть проблеми, робіть нотатки — адже запобігання виникненню таких самих проблем у інших користувачів — чудова тема для першого внеску!

Після того як ви пройдете підручник принаймні до кроку 4, перейдіть до наступного питання.

1. Яке комп'ютерне обладнання у вас є?

Обладнання, яке у вас є, накладає практичні обмеження на те, у чому ви можете взяти участь. Наприклад, якщо у вас ноутбук на Windows, ви не зможете працювати над проектами, пов'язаними з iOS. На якому операційному системі працює ваш ноутбук: Windows, macOS, Linux чи на чомусь іншому? Ваш телефон працює на iOS чи Android? Ваші пристрої надані роботодавцем чи це ваші особисті пристрої?

1. Який у вас досвід написання коду на Python?

Ви тільки починаєте займатися програмуванням? Або вже досвідчений програміст на Python? Або досвідчений програміст, який тільки-но почав вивчати Python? Або щойно закінчили буткемп? Ми хочемо підібрати для вас задачу, яка відповідатиме вашому рівню досвіду.

1. Чи знайомі ви з процедурами внесення змін на GitHub?

Чи користуєтеся ви GitHub (або подібним сервісом для обміну кодом) для розміщення власного коду чи участі в проектах інших розробників? Чи знаєте ви, що таке CI (безперервна інтеграція)? Чи брали ви участь у проекті, де використовуються пре-комміт-хуки? Якби я попросив вас «rebase ваш PR до гілки main», чи знали б ви, що робити?

1. Чи брали ви раніше участь у розробці проєкту з відкритим кодом?

Чи брали ви участь у спринті раніше? Чи надсилали ви коли-небудь PR (pull request) до проєкту з відкритим кодом? Чи знаєте ви, як користуватися GitHub для створення pull request?

1. Чи є у вас якісь інші особливі навички, які могли б стати в нагоді?

Чи знайомі ви з API графічного інтерфейсу користувача (наприклад, WinForms, Cocoa або GTK)? Чи маєте ви глибокі знання про внутрішню структуру певної операційної системи? Чи є ви експертом у мові програмування, відмінній від Python? Якщо у вас немає жодних особливих навичок, це не проблема — але якщо у нас є справжній гуру Windows, ми хочемо переконатися, що ці навички будуть використані з користю.

1. Чому ви приєдналися до нас і що вас цікавить?

«Ви справили враження приємного проєкту» — це цілком прийнятна відповідь. Однак, якщо є ще якісь причини, через які ви сьогодні приєдналися до нас, повідомте нам про це. Вас цікавить розробка мобільних чи настільних додатків? Пакування? Веб-сайти? Консольні додатки? Якщо у вас немає конкретних інтересів — що вам здається найцікавішим з того, що ви досі побачили про BeeWare?

А тепер знайдіть когось із команди «Bee», щоб поділитися своїми відповідями. Можливо, вам зададуть кілька додаткових запитань, але потім вам підкажуть, у якій сфері ви зможете зробити свій внесок.

Знайдіть потрібний випуск

Якщо ви спілкувалися з кимось із команди Bee, то, ймовірно, вам вказали на ту частину проєкту BeeWare, де ви можете долучитися; можливо, вам навіть запропонували конкретну проблему, над якою можна попрацювати. Якщо вам не вказали конкретну проблему, то, ймовірно, вам порадили переглянути розділ «Good First Issues» для цього проєкту. Що це означає?

GitHub надає список проблем, який дозволяє BeeWare (та іншим проєктам) відстежувати всі повідомлені проблеми — це включає явні помилки, несподівану поведінку, яка може бути помилкою, запити на нові функції, запити на додаткову документацію — все, що може сприяти вдосконаленню BeeWare. У міру надходження нових проблем команда Bee позначатиме деякі з них як такі, що добре підходять для тих, хто вперше бере участь у розробці — це проблеми, які не вимагають негайного виправлення, але чітко сформульовані або їх легко відтворити, і, ймовірно, мають чітке уявлення про їхню основну причину. Ці проблеми позначаються тегом «good first issue», щоб їх було легше знайти.

Щоб відфільтрувати список завдань на GitHub за міткою «good first issue», виконайте такі дії:

1. Натисніть кнопку «Мітки» над списком проблем, щоб відкрити випадаюче меню.
2. Введіть слово «good» у поле пошуку у верхній частині випадаючого меню.
3. Натисніть на «good first issue» у відфільтрованому списку.

Фільтрування завдань на GitHub за міткою «good first issue».

Як тільки ви знайдете проблему, яка здається вам цікавою, прочитайте всі коментарі до публікації та залиште коментар у дискусії, вказавши, що ви займаєтеся цією проблемою (наприклад: «Вивчаю це під час спринтів PyCon US 2026»). BeeWare не «призначає» проблеми явно — ми приймаємо внески від будь-кого. Однак у ситуації спринту нам потрібно переконатися, що над однією проблемою не працюватимуть дві людини одночасно — залишення коментаря є простим способом координації між учасниками.

Якщо ви все ще не можете знайти те, чим хотіли б зайнятися, зверніться до члена команди Bee — він допоможе вам визначитися з конкретним питанням.

Налаштування середовища розробки

Як тільки ви виявите проблему, вам потрібно буде налаштувати своє середовище розробки, щоб можна було працювати над її усуненням. Кожен проєкт BeeWare має власний посібник для учасників:

• Портфель
• щодо цього
• Rubicon ObjC

Якщо проекту немає в цьому списку, перегляньте файл README проекту, щоб дізнатися, як налаштувати середовище. Якщо якісь інструкції вам незрозумілі (або ви не можете їх знайти), зверніться до когось із команди Bee — вони допоможуть вам вирішити проблему. А якщо ви вважаєте, що можете вдосконалити інструкції, щоб інші люди не стикалися з тією самою проблемою, то вдосконалення посібника з внесення змін — це цінний внесок!

Тепер ви можете приступити до вирішення вашої проблеми!

Що відбудеться після того, як я надішлю свій PR?

Після того як ви надіслали pull request і він пройшов усі автоматичні перевірки, ви готові до рецензування. Повідомте когось із членів основної команди, що у вас є PR, готовий до рецензування, і вони його переглянуть.

Якщо це ваш перший PR, цілком імовірно, що під час рецензування будуть виявлені деякі проблеми. Це може бути крайній випадок, який ви не врахували, або порушення конвенції кодування. Не впадайте у відчай! Ніхто — навіть члени основної команди — не подає PR, які на 100 % правильні з першої спроби.

Як тільки PR пройде перевірку, ваш рецензент об’єднає PR — і все готово! Вітаємо — ви зробили свій внесок у BeeWare! Якщо це ваш перший внесок у BeeWare, ви також заслужили свою монету BeeWare Challenge Coin — зверніться до когось із членів основної команди, і вони вручать вам монету!

Допоможіть! Я застряг!

Якщо ви в будь-який момент зіткнетеся з труднощами, зверніться до когось із команди Bee. Не бійтеся задавати будь-які питання. Якщо ви застрягли, ми хочемо допомогти вам вийти з цієї ситуації. Якщо ви заплуталися, це означає, що тема складна, а ми не пояснили її достатньо чітко. Ми з радістю допоможемо — і хочемо переконатися, що ваш спринт буде успішним.

А що, якщо я не встигну виконати свою частину роботи протягом спринту?

Немає проблем! Ви можете подати свій внесок у будь-який час. Мета спринтів — заохотити вас і надати вам можливість продовжувати робити внески протягом решти року. Команда Bee завжди готова допомогти вам на будь-якому етапі цього процесу.

Якщо ви вже працювали над завданням на GitHub або надіслали PR, ви можете продовжувати спілкуватися через GitHub. Якщо у вас є інші запитання або вам потрібна допомога в режимі реального часу, найкраще звертатися до нас на сервер BeeWare у Discord. Ми з нетерпінням чекаємо на подальшу співпрацю з вами!

Вдосконалення цього посібника

Якщо у вас є пропозиції щодо вдосконалення цього посібника зі спринтів, повідомте нам про це. Що вам допомогло? А що — ні? Що ми можемо зробити краще? І пам’ятайте: усунення проблеми в цьому посібнику зі спринтів вважається внеском у розвиток BeeWare!