Руководство по спринту

Добро пожаловать в BeeWare Sprints!

Добро пожаловать! Мы очень рады, что вы решили присоединиться к нам! Если вы еще не представились кому-либо из команды Bee, пожалуйста, сделайте это. После этого вернитесь сюда, чтобы приступить к работе.

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

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

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

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

Код — не единственный способ внести свой вклад. Проект BeeWare — это гораздо больше, чем просто код. Нам нужны люди, которые будут писать, корректировать и переводить документацию; нам нужны люди, которые будут улучшать дизайн веб-страниц; даже процесс просмотра ошибок, о которых сообщалось несколько лет назад, и определения, что они были исправлены, является ценным вкладом.

Начальные вопросы

Для начала мы зададим вам несколько вопросов, чтобы оценить ваши интересы и опыт. Это поможет нам найти лучший способ для вас внести свой вклад. Проработайте вопросы, сделайте заметки, а затем найдите члена команды Bee и поделитесь своими ответами. Если вы не понимаете задаваемый вопрос — не беспокойтесь! Сообщите нам, что вы знаете, и мы вместе разберемся в этом.

1. Вы уже пользовались BeeWare?

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

После того, как вы пройдете учебник как минимум до шага 4, переходите к следующему вопросу.

1. Какое компьютерное оборудование у вас есть?

Оборудование, которое у вас есть, накладывает практические ограничения на то, чем вы можете заниматься. Например, если у вас ноутбук с Windows, вы не сможете работать над чем-либо, связанным с iOS. На вашем ноутбуке установлена Windows, macOS, Linux или что-то еще? Ваш телефон — устройство на iOS или Android? Ваши устройства предоставлены работодателем или это ваши личные устройства?

1. Какой у вас опыт написания кода на Python?

Вы новичок в программировании? Ветеран Python? Ветеран кодирования, который только начал изучать Python? Недавний выпускник программы bootcamp? Мы хотим найти задачу, которая будет соответствовать вашему уровню опыта.

1. Вы знакомы с процессами участия в GitHub?

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

1. Вы когда-нибудь участвовали в проекте с открытым исходным кодом?

Вы когда-нибудь участвовали в спринте? Вы когда-нибудь отправляли PR (запрос на добавление) в проект с открытым исходным кодом? Вы знаете, как использовать GitHub для создания запроса на добавление?

1. Есть ли у вас другие специальные навыки, которые могут пригодиться?

Вы знакомы с GUI API (такими как WinForms, Cocoa или GTK)? Вы обладаете глубокими знаниями о внутреннем устройстве конкретной операционной системы? Вы являетесь экспертом в языке программирования, отличном от Python? Если у вас нет каких-либо специальных навыков, это не проблема, но если у нас есть гуру Windows, мы хотим быть уверены, что эти навыки будут использованы с пользой.

1. Почему вы присоединились к нам и что вас интересует?

«Вы показались мне дружелюбным проектом» — вполне подходящий ответ. Однако, если есть еще какие-то причины, по которым вы присоединились к нам сегодня, дайте нам знать. Вы интересуетесь разработкой мобильных или настольных приложений? Упаковкой? Веб-сайтами? Консольными приложениями? Если у вас нет конкретных интересов, что вам кажется наиболее интересным из того, что вы видели о BeeWare до сих пор?

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

Найдите свою проблему

Если вы поговорили с членом команды Bee, он, вероятно, указал вам на часть проекта BeeWare, в которую вы можете внести свой вклад; возможно, он даже предложил вам конкретную задачу для работы. Если он не дал вам конкретной задачи, то, вероятно, указал вам на «Хорошие первые задачи» для этого проекта. Что это означает?

GitHub предоставляет список проблем, который позволяет BeeWare (и другим проектам) отслеживать все проблемы, о которых было сообщено, включая явные ошибки, неожиданное поведение, которое может быть ошибкой, запросы на новые функции, запросы на дополнительную документацию — все, что может помочь улучшить BeeWare. По мере появления новых проблем команда Bee будет отмечать некоторые из них как проблемы, которые хорошо подходят для начинающих участников — проблемы, которые не требуют немедленного решения, но хорошо определены или легко воспроизводятся и, вероятно, имеют хорошее представление о первопричине. Эти проблемы помечаются тегом «хорошая первая проблема», чтобы их было легче найти.

Чтобы отфильтровать список проблем GitHub по метке «good first issue», выполните следующие действия:

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

Фильтрация проблем GitHub по метке «good first issue» (хорошая первая проблема).

Как только вы нашли интересную проблему, прочтите все комментарии к посту и оставьте свой комментарий в дискуссии, сообщив, что вы занимаетесь этой проблемой (например, «Работаю над этим на спринтах PyCon US 2025»). BeeWare не «назначает» задачи явно — мы принимаем вклады от всех желающих. Однако в условиях спринта нам нужно убедиться, что над одной и той же задачей не будут работать два человека — оставление комментария — это простой способ координировать работу участников.

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

Настройте среду разработки

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

• Briefcase
• того
• Rubicon ObjC

Если проект не входит в этот список, ознакомьтесь с файлом README проекта, чтобы узнать, как его настроить. Если какие-либо инструкции вам не понятны (или вы не можете их найти), обратитесь к члену команды Bee, и он поможет вам решить проблему. А если вы считаете, что можете улучшить инструкции, чтобы другие люди не сталкивались с той же проблемой, улучшение руководства по внесению вклада будет ценным вкладом!

Теперь вы можете приступить к работе над своей проблемой!

Что произойдет после того, как я подам заявку на получение ПМЖ?

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

Если это ваш первый PR, вполне вероятно, что при проверке будут обнаружены некоторые проблемы. Это может быть крайний случай, который вы не учли, или соглашение о коде, которое вы не соблюли. Не расстраивайтесь! Никто, даже основная команда, не получает PR, которые на 100% правильны с первой попытки.

Как только PR пройдет проверку, ваш рецензент объединит PR — и все готово! Поздравляем — вы внесли свой вклад в BeeWare! Если это ваш первый вклад в BeeWare, вы также заработали BeeWare Challenge Coin — найдите члена основной команды, и он даст вам монету!

Помогите! Я застрял!

Если вы застряли на каком-либо этапе, обратитесь к члену команды Bee. Не бойтесь задавать любые вопросы. Если вы застряли, мы хотим вам помочь. Если вы запутались, это потому, что тема сложная, и мы не объяснили ее достаточно хорошо. Мы готовы помочь — и хотим, чтобы ваш спринт прошел успешно.

Что, если я не завершу свой вклад во время спринта?

Нет проблем! Вы можете отправить свой вклад в любое время. Цель спринтов — мотивировать вас и дать вам возможность продолжать вносить свой вклад в течение всего остального года. Команда Bee готова помочь вам на любом этапе этого процесса.

Если вы уже работали над проблемой в GitHub или отправили PR, вы можете продолжить общение через GitHub. Если у вас есть другие вопросы или вам нужна помощь в режиме реального времени, лучшее место, где вы можете нас найти, — это сервер BeeWare Discord. Мы с нетерпением ждем продолжения сотрудничества с вами!

Улучшение данного руководства

Если у вас есть предложения по улучшению этого руководства по спринтам, сообщите нам. Что сработало для вас? Что не сработало? Что мы можем сделать лучше? И помните: решение проблемы с помощью этого руководства по спринтам считается вкладом в BeeWare!