コンテンツにスキップ

FastAPIを応援 - ヘルプの入手

🌐 AI と人間による翻訳

この翻訳は、人間のガイドに基づいて AI によって作成されました。🤝

原文の意図を取り違えていたり、不自然な表現になっている可能性があります。🤖

AI LLM をより適切に誘導するのを手伝う ことで、この翻訳を改善できます。

英語版

FastAPI は気に入りましたか？

FastAPIや他のユーザー、作者を応援したいですか？

それとも FastAPI についてヘルプが必要ですか？

とても簡単に応援できる方法があります（1、2回クリックするだけのものもあります）。

ヘルプを得る方法もいくつかあります。

ニュースレターを購読

FastAPI and friends ニュースレター（配信はまれです）を購読すると、次の情報をキャッチアップできます:

  • FastAPI と関連プロジェクトのニュース 🚀
  • ガイド 📝
  • 機能 ✨
  • 互換性に影響する変更 🚨
  • ヒントやコツ ✅

X (Twitter) で FastAPI をフォロー

X (Twitter) で @fastapi をフォローして、FastAPI の最新情報を受け取りましょう。🐦

GitHubで FastAPI にStar

GitHubでFastAPIに「Star」をつけることができます（右上部のStarボタンをクリック）: https://github.com/fastapi/fastapi。⭐️

スターを増やすことで、他のユーザーの目につきやすくなり、すでに多くの人の役に立っていることが伝わります。

GitHubレポジトリのリリースをWatch

GitHubでFastAPIを「Watch」できます（右上部の「Watch」ボタンをクリック）: https://github.com/fastapi/fastapi。👀

そこで「Releases only」を選択できます。

これを行うと、バグ修正や新機能を含む FastAPI の新しいリリース（新バージョン）があるたびに、（メールで）通知を受け取れます。

開発者とつながる

作者である私（Sebastián Ramírez / tiangolo）とつながれます。

できること:

  • GitHub でフォロー。
    • 役に立つかもしれない、私が作成した他のオープンソースプロジェクトを見られます。
    • 新しいオープンソースプロジェクトを作成したときにわかります。
  • X (Twitter) でフォロー または Mastodon。
    • あなたがどのようにFastAPIを使っているか教えてください（聞けると嬉しいです）。
    • 新しいツールの告知やリリースを聞けます。
    • さらに、X (Twitter) の @fastapi（別アカウント）もフォローできます。
  • LinkedIn でフォロー。
    • 新しいツールの告知やリリースを聞けます（ただしX (Twitter) の方をよく使っています 🤷‍♂）。
  • Dev.to や Medium で執筆内容を読む（またはフォロー）。
    • 私のアイデアや、作成したツールに関する記事を読めます。
    • 新しい記事を公開したときに読めます。

FastAPI についてツイート

FastAPI についてツイートして、なぜ気に入っているのかを私や他の人に教えてください。🎉

FastAPI がどのように使われているか、どこを気に入っているか、どのプロジェクト/会社で使っているか等、聞けると嬉しいです。

FastAPIに投票

GitHubで質問に困っている人を助ける

次の場所で、他の人の質問を手助けできます:

多くの場合、その質問の答えをすでに知っているかもしれません。🤓

もし多くの人の質問に答えて助けてくれたなら、あなたは公式のFastAPI Expertになります。🎉

最も大事なポイントは「親切であること」を心がけることです。人はフラストレーションを抱えてやって来るので、必ずしも最良の聞き方をしているとは限りませんが、できる限り親切に対応しましょう。🤗

FastAPI コミュニティは親切で歓迎的であることを目指しています。同時に、いじめや他者への無礼な振る舞いは受け入れないでください。お互いを大事にしましょう。

以下は（Discussions や Issues で）他の人の質問を手助けする方法です:

質問を理解する

  • 質問者の「目的」やユースケースを理解できるか確認します。

  • 次に、質問（大半は質問です）が「明確」か確認します。

  • 多くの場合、ユーザーが想像した解決策についての質問になっていますが、もっと「良い」方法があるかもしれません。問題やユースケースをよりよく理解できれば、より良い「代替解決策」を提案できるかもしれません。

  • 質問が理解できない場合は、さらに「詳細」を尋ねます。

問題を再現する

多くのケースや質問は、その人の「元のコード」に関係しています。

しばしばコードの断片だけが共有されますが、それでは問題を「再現」するには不十分です。

  • ローカルで同じエラーや挙動を確認できるように、またはユースケースをよりよく理解できるように、コピー&ペーストして実行できる最小の再現可能な例の提供を依頼できます。

  • とても寛大な気分なら、問題の説明だけをもとに、あなた自身でそのような例を作成してみることもできます。ただし時間がかかる可能性が高いので、まずは問題の明確化を依頼した方が良い場合もあります。

解決策を提案する

  • 質問を理解できたら、可能な回答を提示できます。

  • 多くの場合、相手の「根本的な問題やユースケース」を理解することが重要です。相手が試している方法より良い解決方法があるかもしれないからです。

クローズを依頼する

もし相手が返信してきて、あなたが問題を解決できたなら、おめでとう、あなたはヒーローです！🦸

  • その場合、次のように依頼できます:

    • GitHub Discussions: コメントを回答としてマークしてもらう。
    • GitHub Issues: issue をクローズしてもらう。

GitHubレポジトリをWatch

GitHubでFastAPIを「Watch」できます（右上部の「Watch」ボタンをクリック）: https://github.com/fastapi/fastapi。👀

「Releases only」ではなく「Watching」を選択すると、新しい issue や質問が作成されたときに通知を受け取れます。新しい issue のみ、Discussions のみ、PR のみ、など通知対象を絞ることもできます。

その上で、そうした質問の解決を手助けできます。

質問する

GitHubレポジトリで新しい質問を作成できます。例えば:

  • 質問をする、または問題について尋ねる。
  • 新しい機能を提案する。

Note: もしそうするなら、他の人の手助けもお願いします。😉

プルリクエストをレビュー

他の人からのプルリクエストのレビューを手伝ってもらえます。

ここでも、できる限り親切であるようにしてください。🤗

プルリクエストをレビューするときのポイントです:

問題を理解する

  • まず、そのプルリクエストが解決しようとしている問題を理解してください。長めの議論が GitHub Discussion や issue にあるかもしれません。

  • その問題は実は別の方法で解決でき、プルリクエスト自体が不要な場合もあります。その場合は、その提案や質問をしても良いでしょう。

スタイルは気にしすぎない

  • コミットメッセージのスタイルなどはあまり気にしなくて大丈夫です。私は squash and merge を使い、コミットを手動で調整します。

  • スタイルルールについても心配無用です。自動化ツールがすでにチェックしています。

ほかにスタイルや一貫性の要件があれば、私から直接依頼しますし、必要な変更を上に積む形でコミットを追加します。

コードを確認

  • コードを確認して読み、妥当かどうかを見て、ローカルで実行し、本当に問題を解決しているか確かめてください。

  • そのうえで、それを行ったことをコメントで伝えてください。そうすれば、実際に確認してくれたとわかります。

情報

残念ながら、承認が複数ついただけのPRを、そのまま信頼することはできません。

説明が魅力的なためか、3件、5件以上の承認がついていても、実際にPRを確認すると壊れていたり、バグがあったり、主張する問題を解決していなかったりすることが何度もありました。😅

ですので、実際にコードを読み、実行して確認し、それをコメントで知らせてもらえることが本当に重要です。🤓

  • もしPRを簡素化できそうなら、その依頼をしても構いませんが、細かい点にこだわり過ぎる必要はありません。主観的な見方が多く（私にもあります 🙈）、基本的な点に集中できるとより良いでしょう。

テスト

  • PRにテストがあるか確認を手伝ってください。

  • PR前はテストが失敗することを確認します。🚨

  • そしてPR後にテストが成功することを確認します。✅

  • 多くのPRにはテストがありません。テストの追加をリマインドしたり、テストを提案したりできます。これは最も時間を消費する部分の一つで、大いに助けになります。

  • 何を試したかもコメントしてください。そうすれば、確認してくれたことがわかります。🤓

プルリクエストを作成

貢献として、次のようにプルリクエストでソースコードに貢献できます:

  • ドキュメントで見つけたタイポの修正。
  • 自分が作成/発見した FastAPI に関する記事・動画・ポッドキャストを、このファイルを編集して共有。
    • 該当セクションの先頭にリンクを追加してください。
  • 自分の言語へのドキュメント翻訳を手伝う。
    • 他の人が作成した翻訳のレビューも手伝えます。
  • 新しいドキュメントセクションの提案。
  • 既存のissue/バグの修正。
    • テストを追加してください。
  • 新機能の追加。
    • テストを追加してください。
    • 関連があればドキュメントも追加してください。

FastAPIのメンテナンスを手伝う

FastAPI のメンテナンスを手伝ってください！🤓

やることはたくさんあり、その多くはあなたにもできます。

今すぐできる主なタスクは次のとおりです:

この2つが最も時間を消費します。FastAPI のメンテナンス作業の中心です。

これを手伝ってもらえると、FastAPIのメンテナンスに貢献し、より速く・より良く前進できるようになります。🚀

チャットに参加

👥 Discord チャットサーバー 👥 に参加し、FastAPI コミュニティのみんなと交流しましょう。

豆知識

質問は GitHub Discussions に投稿してください。そこならFastAPI Expertsから助けてもらえる可能性がずっと高いです。

チャットは一般的な会話のみに使いましょう。

質問でチャットを使わない

チャットは「自由な会話」がしやすいため、一般的すぎて答えにくい質問になりがちです。そのため、回答が得られない可能性があります。

GitHub では、テンプレートが正しい形で質問を書くのを助けてくれるため、良い回答を得やすくなりますし、質問する前に自分で問題を解決できることもあります。さらにGitHubなら、時間がかかっても私が必ずすべてに回答できるようにできます。チャットでは私個人にはそれができません。😅

チャットでの会話はGitHubほど検索しやすくないため、質問と回答が会話に埋もれがちです。そして、FastAPI ExpertになるためにカウントされるのはGitHub上の活動だけです。ですから、GitHubの方が注目を集めやすいでしょう。

一方で、チャットには数千人のユーザーがいるため、ほぼ常に誰かと会話できる可能性が高いです。😄

あなたの製品/会社が FastAPI に依存している、または関連しており、そのユーザーにリーチしたい場合は、GitHub sponsors を通じて作者（私）を支援できます。プランに応じて、ドキュメントにバッジが表示されるなどの特典がある場合があります。🎁

Thanks! 🚀