Hacktoberfestは、10月中に開催される毎年恒例の世界的なイベントです。 このイベントは、オープン ソースの開発者が pull request (PR) を通じてリポジトリに投稿することを奨励します。 GitHub では、Microsoft Learn コンテンツに貢献する多くのオープン ソース リポジトリがホストされています。 いくつかのリポジトリが Hacktoberfest に積極的に参加しています。
投稿する方法
オープン ソース リポジトリに投稿するには、まず、Microsoft Learn に投稿するようにアカウントを構成する必要があります。 このプロセスを初めて使用する場合は、 まず GitHub アカウントにサインアップします。 Git と Markdown ツールを必ずインストールしてください。
参加のクレジットを取得するには、 Hacktoberfest に登録し、参加ガイドをお読みください。
ヘルプが必要なリポジトリを見つける
PowerShell-Docs チームは、いくつかの PowerShell ドキュメント リポジトリに対する Hacktoberfest の投稿をサポートしています。 最初の貢献者が簡単に取り組めるように設計されたクリーンアップタスクのセットを定義しました。 完全な情報は Hacktoberfest メタイシューにあります。
これらのタスクを正常に実行するには、次の手順を実行する必要があります。
- PowerShell 構文について一般的に理解する
- スプラッティングについて理解を深める
- PowerShell-Docs スタイルガイドと編集チェックリストを読んで従うことができる
- Markdown に関する基本的な知識がある
投稿する前に、メタイシューを読む必要があります。 開始する準備ができたら、次のいずれかのリンクを使用して新しい Hacktoberfest を開きます。
- MicrosoftDocs/PowerShell-Docs
- MicrosoftDocs/PowerShell-Docs-DSC
- MicrosoftDocs/PowerShell-Docs-Modules
- MicrosoftDocs/windows-powershell-docs
- MicrosoftDocs/azure-docs-powershell
品質の期待
オープン ソースの Microsoft Learn リポジトリへの貢献を成功させるには、意味のあるインパクトのある PR を作成します。 公式の Hacktoberfest サイトの次の例は、 低品質の投稿と見なされます。
- 一括自動変更を含む PR
- 例: 空白を削除したり、一般的なスペルを修正したり、画像を最適化したりするためのスクリプト化された PR
- 最初に、行う自動変更について説明する問題を送信する
- PR が破壊的と見なされた (たとえば、他のユーザーのブランチやコミットを取得して PR を作成するなど)
- PR は障害と見なされる一方で、役立つとも考えられた
- 明らかに 10 月の PR 数を増やそうとしている PR
PR をオープンする
PR は、共同作成者が一連の変更を提案する便利な方法を提供します。 成功した PR には、次の一般的な特性があります。
- PR によって値が追加されます。
- 共同作成者はフィードバックを受け入れている。
- 意図された変更は明確に示されています。
- 変更は、既存の問題に関連しています。
対応する問題なしで PR を提案する場合は、最初に問題を作成します。 詳細については、「 GitHub: pull request について」を参照してください。
こちらも参照ください
PowerShell