次の方法で共有

PowerShell ドキュメントへの投稿

PowerShell のサポートに感謝します。

共同作成者ガイドは、Microsoft でドキュメントを作成するために使用するツールとプロセスについて説明する記事のコレクションです。 これらのガイドの一部では、 learn.microsoft.comに公開されているドキュメント セットに共通する情報について説明します。 その他のガイドは、PowerShell のドキュメントを記述する方法に固有です。

一般的な記事は、一元化された 共同作成者ガイドで入手できます。 PowerShell 固有のガイドについては、こちらをご覧ください。

貢献する方法

投稿する方法は 2 つあります。 どちらの貢献も、私たちにとって価値があります。

  • 問題の提出は 、ドキュメント内の問題とギャップを特定するのに役立ちます。 場合によっては、問題の解決が難しく、より多くの調査と調査が必要な場合があります。 問題プロセスを使用すると、問題に関する会話を行い、満足できる解決策を開発できます。

  • コンテンツを追加または変更するための pull request の送信は、より複雑なプロセスです。 次の情報は、ドキュメントにコンテンツを送信するためのツール、プロセス、および標準の概要を示しています。

コントリビューションを作成する準備をする

ドキュメントに投稿するには、GitHub アカウントが必要です。 次のチェックリストを使用して、貢献するために必要なツールをインストールして構成します。

  1. GitHub にサインアップする
  2. Git ツールと Markdown ツールをインストールする
  3. Docs Authoring Pack をインストールする
  4. Posh-Git をインストールする - 必須ではありませんが、推奨
  5. ローカル Git リポジトリを設定する
  6. Git と GitHub の基礎を確認する

ドキュメントの作成を開始する

ドキュメントに変更を加える方法は 2 つあります。

  1. 既存のドキュメントに対するクイック編集 - 軽微な修正、入力ミスの修正、または小さな追加
  2. ドキュメントの完全な GitHub ワークフロー - 大規模な変更、複数のバージョン、イメージの追加または変更、新しい記事の投稿

また、集中型の投稿者ガイドの執筆の基本セクションを参照してください。 もう 1 つの優れたリソースは、 Microsoft ライティング スタイル ガイドです。

パブリック リポジトリのドキュメントとコード例に対する軽微な修正または明確化については、 learn.microsoft.com 使用条件の対象となります。

大幅な変更を加える場合は、完全な GitHub ワークフローを使用します。 Microsoft の従業員でない場合、MICROSOFT の PR 検証システムは、オンライン 投稿ライセンス契約 (CLA) への署名を求めるコメントを pull request に追加します。 pull request を確認または受け入れる前に、この手順を完了する必要があります。 CLA への署名は、リポジトリで PR を初めて送信するときにのみ必要です。 新しいリポジトリに投稿するたびに、CLA に署名するように求められる場合があります。

行動規範

Microsoft Learn に発行するすべてのリポジトリは、 Microsoft オープン ソースの行動規範 または .NET Foundation の行動規範に準拠しています。 詳細については、行動規範に関する FAQ を参照 してください。

次のステップ

次の記事では、PowerShell ドキュメントに固有の情報について説明します。 一元化された共同作成者ガイドのガイダンスと重複している場合は、PowerShell コンテンツに対してこれらのルールがどのように異なるかを説明します。

以下のドキュメントを確認してください。

その他のリソース