スプリントガイド¶
BeeWare・スプリントへようこそ！¶
ようこそ！ご参加いただき、大変嬉しく思っております！まだビーチームのメンバーにご挨拶を済ませていない場合は、ぜひお済ませください。ご挨拶を終えたら、こちらに戻ってスタートしましょう。
スプリントとは何ですか？¶
スプリントとは、数時間から数日にわたりオープンソースプロジェクトに共同で取り組む、自由な形式の機会です。多くの場合、カンファレンスと連動して開催されます。カンファレンス後のスプリントは、カンファレンスで生まれたエネルギーや熱意、関心を、日常的に使用するソフトウェアの改善へとつなげる機会を提供します。
スプリントは、プロジェクトへの貢献プロセスを紹介する機会でもあります。スプリント期間中に貢献する楽しさを存分に味わっていただき、帰宅後も継続的に貢献していただけることを願っています！
経験の多さは問題ではありません。過去のスプリントでは、高校生、ブートキャンプ卒業生、自らをプログラマーとは思っていない方々、そしてベテラン開発者まで、あらゆる経験レベルの方々の貢献を統合してきました。あなたの経験レベルに関わらず、貢献できる方法を見つけられます。
コードだけが貢献の方法ではありません。BeeWareのようなプロジェクトは単なるコード以上のものです。ドキュメントの執筆、校正、翻訳をしてくれる人々が必要です。ウェブページのデザインを改善してくれる人々も必要です。何年も前に報告されたバグを検証し、その過程で修正されたと判断する作業さえも、貴重な貢献なのです。
最初の質問¶
まずは始めに、あなたの興味や経験を把握するため、いくつか質問をさせていただきます。これにより、あなたに最適な貢献方法を見つける手助けとなります。質問に答えながらメモを取り、その後ビーチームのメンバーを見つけて回答を共有してください。質問の内容が理解できなくても心配はいりません！ご存知の情報を教えてください。そこから一緒に考えましょう。
- BeeWareを使ったことはありますか？
まだの方は、まずBeeWareチュートリアルを進めてください。このチュートリアルでは、BeeWareプロジェクトの概要と、プロジェクトの各構成要素がどのように連携しているかについて学ぶことができます。チュートリアルを進める中で問題に遭遇した場合は、メモを取っておきましょう。同じ問題が他の人にも発生しないようにすることは、初めての貢献として最適なテーマです！
チュートリアルを少なくともステップ4まで完了したら、次の質問に進んでください。
- どのようなコンピューター機器をお持ちですか？
お持ちの機器によって、貢献できる範囲には現実的な制限が生じます。例えば、Windowsノートパソコンをお持ちの場合、iOS関連の作業はできません。お使いのノートパソコンはWindows、macOS、Linux、またはその他のOSですか？お使いのスマートフォンはiOS端末ですか、それともAndroid端末ですか？これらの機器は雇用主から提供されたものですか、それとも個人の所有物ですか？
- Pythonコードの記述経験はどの程度ありますか？
プログラミング初心者ですか？Pythonのベテランですか？コーディングのベテランでPythonを学び始めたばかりですか？ブートキャンププログラムの卒業生ですか？あなたの経験レベルに合った課題を見つけたいと考えています。
- GitHubの貢献プロセスについてご存知ですか？
GitHub（または類似のコード共有サイト）を使って自身のコードをホスティングしたり、他人のプロジェクトに貢献したりしていますか？CI（継続的インテグレーション）とは何か知っていますか？プレコミットフックが設定されているプロジェクトに貢献したことはありますか？もし「メインブランチに対してPRをrebaseしてください」と頼まれたら、何をすべきか分かりますか？
- これまでオープンソースプロジェクトに貢献したことはありますか？
過去にスプリントに参加したことはありますか？オープンソースプロジェクトにプルリクエスト（PR）を提出したことはありますか？GitHubを使ってプルリクエストを作成する方法をご存知ですか？
- 他に役立つ特別なスキルはありますか？
GUI API（WinForms、Cocoa、GTKなど）に精通していますか？特定のオペレーティングシステムの内部構造について深い知識をお持ちですか？Python以外のプログラミング言語の専門家ですか？特別なスキルがなくても問題ありません——ただし、もしWindowsの達人がいれば、そのスキルが十分に活かされていることを確認したいと考えています。
- なぜ当社に入社されたのですか？また、どのようなことに興味をお持ちですか？
「友好的なプロジェクトに聞こえたから」という答えは全く問題ありません。ただし、本日参加された理由に何か他の要素があるなら、ぜひお聞かせください。モバイル開発やデスクトップ開発に興味がありますか？パッケージング？ウェブサイト？コンソールアプリ？もし特定の関心分野がない場合、これまでBeeWareについてご覧になった中で、最も興味深いと感じた点はどこでしょうか？
さあ、あなたの回答を共有できるビーチームのメンバーを探しましょう。彼らは追加の質問をするかもしれませんが、その後、あなたが貢献できる分野の方向性を示してくれるでしょう。
問題を見つける¶
もしビーチームのメンバーと話したことがあるなら、おそらく彼らはあなたが貢献できるBeeWareプロジェクトの一部を教えてくれたはずです。特定の課題に取り組むよう提案してくれたかもしれません。具体的な課題を提示されなかった場合でも、おそらくそのプロジェクトの「Good First Issues」を紹介してくれたでしょう。これはどういう意味でしょうか？
GitHubは、報告された全ての問題を追跡するための課題リストを提供しています。これには、明確なバグ、バグの可能性がある予期せぬ動作、新機能のリクエスト、ドキュメント拡充のリクエストなど、BeeWareを改善する可能性のあるあらゆる事項が含まれます。 新たな課題が報告されると、Beeチームはその中から「初めての貢献者に適した課題」を特定します。これらは即時修正を必要とせず、明確に定義されているか再現が容易で、根本原因の特定が進んでいる課題です。これらの課題は「good first issue」タグが付与され、見つけやすくなっています。
GitHubの課題リストを「good first issue」ラベルでフィルタリングするには、次の手順に従ってください：
- 課題リストの上にある「ラベル」ボタンをクリックして、ドロップダウンメニューを有効にしてください。
- ドロップダウンメニューの上部にある検索ボックスに「good」と入力してください。
- フィルタリングされたリスト内の「良い初回号」をクリックしてください。
「good first issue」ラベルでGitHubの課題（イシュー）をフィルタリングする。
興味深い課題を見つけたら、その投稿へのコメントをすべて読み、議論に「この課題を検討中です（例：PyCon US 2025 スプリントで調査中）」とコメントを投稿してください。 BeeWareでは明示的な「課題の割り当て」は行いません。どなたからの貢献も歓迎します。ただしスプリント環境では、同じ課題に複数人が重複して取り組む事態を避ける必要があります。コメントを残すことは、貢献者間で調整を行うための軽量な方法です。
もしそれでもやりたいことが見つからない場合は、Bee Teamのメンバーを見つけてください。彼らが具体的な課題に絞り込むお手伝いをします。
開発環境を構築する¶
問題を発見したら、修正作業を行うために開発環境を設定する必要があります。各BeeWareプロジェクトには独自の貢献ガイドがあります：
プロジェクトがこのリストにない場合は、プロジェクトのREADMEでセットアップ方法の詳細を確認してください。手順が理解できない場合（または手順が見つからない場合）、Bee Teamのメンバーに連絡してください。問題解決をお手伝いします。また、同じ問題に他人が直面しないよう手順を改善できると思うなら、貢献ガイドの改善は貴重な貢献となります！
さあ、問題の解決に取り掛かりましょう！
プルリクエストを送信した後はどうなりますか？¶
プルリクエストを送信し、自動チェックをすべて通過したら、レビューの準備が整います。レビュー可能なプルリクエストが準備できたことをコアチームのメンバーに知らせてください。確認してもらえます。
これが初めてのプルリクエストなら、レビューで問題が見つかる可能性は十分あります。想定していなかったエッジケースや、守られていないコード規約などかもしれません。がっかりしないでください！誰も——コアチームでさえ——最初の試みでプルリクエストを100%完璧にできるわけではありません。
プルリクエストがレビューを通過したら、レビュアーがマージします。これで完了です！おめでとうございます、BeeWareへの貢献を果たしました！これが初めてのBeeWareへの貢献であれば、BeeWareチャレンジコインも獲得できます。コアチームのメンバーを見つけてください。コインを贈呈します！
助けて！行き詰まっちゃった！¶
途中で詰まったら、ビーチームのメンバーを探してください。どんな質問でも遠慮なく聞いてください。行き詰まっているなら、私たちが解決します。混乱しているなら、それはトピックが複雑で、私たちが十分に説明できていないからです。私たちは喜んでお手伝いします。そして、あなたのスプリントが成功することを願っています。
スプリント中に貢献を完了できなかったらどうなりますか？¶
問題ありません！いつでも貢献を提出できます。スプリントの目的の一つは、あなたが今年残りの期間も貢献を続けられるよう励まし、支援することです。ビーチームはこのプロセスのどの部分でもお手伝いします。
GitHubのイシューに取り組んでいる場合やプルリクエストを提出済みの場合は、引き続きGitHubを通じて連絡を取ることができます。その他の質問やリアルタイムのサポートが必要な場合は、BeeWare Discordサーバーが最適な場所です。引き続きご協力いただけることを楽しみにしております！
このガイドの改善¶
このスプリントガイドの改善点についてご提案があればお知らせください。何が役に立ちましたか？何が役に立ちませんでしたか？何を改善できますか？そして覚えておいてください：このスプリントガイドの問題を修正することは、BeeWareへの貢献としてカウントされます！