英語で読む

次の方法で共有


Hacktoberfest と Microsoft Learn

Hacktoberfest は、毎年 10 月に開催される世界規模のイベントです。 このイベントでは、オープン ソース開発者が pull requests (PR) を通じてリポジトリに投稿できます。 GitHub は、Microsoft Learn コンテンツに投稿する多くのオープンソース リポジトリをホストします。 一部のリポジトリは Hacktoberfest イベントに積極的に参加しています。 この記事では、PR を受け入れているリポジトリの探し方、共同作成者として何を期待できるのかについて学習します。

リポジトリを検索する

Microsoft Learn のリポジトリが Hacktoberfest に参加しているかどうかを調べるには、プロジェクトの hacktoberfest トピックを参照してください。

GitHub .NET docs repository with hacktoberfest topic.

hacktoberfest トピックが含まれる Microsoft Learn と .NET リポジトリをすべてフィルター処理する場合は、GitHub のトピック: Hacktoberfest を参照してください。

または、リポジトリで代わりに Hacktoberfest ラベルを使用することもできます。 このラベルは、イシューをフィルター処理する場合に便利です。 詳細については、ラベルを使ったイシューと pull request のフィルター処理に関する記事を参照してください。

ヒント

リポジトリ管理者であり、リポジトリが Hacktoberfest に参加できるようにする場合は、リポジトリに hacktoberfest トピックを追加します。 詳細については、「トピックを使用したリポジトリの分類」を参照してください。

投稿

オープンソース リポジトリに投稿するには、まず、Microsoft Learn に投稿するようにアカウントを構成する必要があります。 このプロセスを完了したことがない場合は、まず GitHub アカウントにサインアップします。 また、作業を追跡するためにプロファイルを登録する必要もあります。 Hacktoberfest を参照してください。

アカウントを構成したら、まず、投稿するリポジトリのルートにある CONTRIBUTING.md ファイルを読み、これに準拠します。 これらのファイルは、投稿する際のガイドとして機能します。 一般的な Microsoft Learn リポジトリの共同作成者ガイドの例を次に示します。

リポジトリに CODE_OF_CONDUCT.md ファイルがある場合は、マークダウン ファイルの投稿に加えて、コミュニティで期待される行動に従う必要があります。 ここでも、いくつかの一般的な例を次に示します。

詳細については、Hacktoberfest: Participation を参照してください。

問題を選択してください

参加しているリポジトリで作業するイシューを見つけるには、up-for-grabs または help-wanted のどちらかの GitHub ラベルのイシューをフィルターします。 他のイシューに対処することもできますが、スコープが定義され、自己完結型であるイシューに集中する方が簡単です。 Microsoft Learn リポジトリに加えて、初心者向けの次のサイトを使用できます。

詳細については、Hacktoberfest: Beginners (Hacktoberfest: 初心者の方へ) を参照してください。

品質に関する期待

オープン ソースの Microsoft Learn リポジトリへの投稿を成功させるには、有意義で影響力のある PR を作成します。 公式の Hacktoberfest サイトの次のような例は、"低品質の投稿" と見なされます。

  • 自動化された PR (空白文字の削除、入力ミスの修正、イメージの最適化を行うためにスクリプト化してオープンされた PR など)。
  • 中断を伴う PR (他のユーザーのブランチやコミットからの PR 作成など)。
  • プロジェクトの保守管理者によって、サポートの妨げと見なされる PR。
  • 10 月の PR 数を単に 1 つ上げるだけなのが明白なサブミット。

最後に、入力ミスを修正するための PR は 1 つでも問題ありませんが、離れた空白文字を削除するための 5 つの PR は認められません。

詳細については、Hacktoberfest: Values を参照してください。

PR をオープンする

PR では、共同作成者が一連の変更を提案するための便利な方法が提供されます。 PR をオープンする場合は、元のコメントで hacktoberfest への投稿を意図していることを指定します。 成功した PR には、次のように共通する特性があります。

  • PR によって価値が高まる。
  • 共同作成者がフィードバックを受け入れている。
  • 意図する変更が十分に明確に示されている。
  • 変更が既存のイシューに関連している。

対応するイシューのない PR を提案する場合は、最初にイシューを作成してください。 詳細については、GitHub: About pull requests (GitHub: pull request について) を参照してください。

関連項目