GitHub issue を使ったドキュメントのレビュー

Microsoft Learn に投稿する最も便利な方法の 1 つは、ドキュメント記事に直接フィードバックを提供することです。 ページのフィードバック リンクを使うと、閲覧中に生じてきた編集や提案、質問、その他の分析情報を提供することができます。 Microsoft Learn のドキュメントのほとんどは GitHub リポジトリに格納されているため、GitHub issue を送信するという GitHub のプロセスを使ってフィードバックを提供することができます。

GitHub issue は、テクノロジ ユーザー、エンジニア、その他の Microsoft Learn の訪問者が特定の記事に対するフィードバックを共有し、追跡できるツールです。 フォームに入力してフィードバックを文書化し、GitHub のソース記事のリポジトリに投稿すると、作成者や所有者に通知されます。 GitHub リポジトリにアクセスしたユーザーは、誰でも issue を確認できます。 バグ報告や機能要求、メモなど、貴重なフィードバックを収集および保存するのに役立ちます。

GitHub でコンテンツをレビューする理由

GitHub でコンテンツのレビューを提供することは、関心または知識があるトピックに投稿する直接的な方法です。 つまり、Microsoft ドキュメントのトピックを調べながら自分のアイデアを追加できるということです。 分析情報を知識のプールに提供することで、何百万人ものユーザーの Microsoft 製品エクスペリエンスを向上させることができます。 フィードバックは、Microsoft 製品やそのサポート コンテンツに依存している他の Microsoft Learn の訪問者向けのコンテンツを向上させます。

ほとんどの場合、GitHub フィードバックを送信すると、その製品のコンテンツ セット担当チームにアイデアを送信することができます。 コンテンツ チームと製品ユーザーの間の、このコラボレーション パスにより、GitHub で直接フィードバックを共有し、議論することができます。

ドキュメントのコンテンツに投稿することで、Professional 特典も得られます。 GitHub は、技術的な投稿を作成して追跡することのできる、よく知られているプラットフォームです。 GitHub 上のプロジェクトに投稿すると、そのたびに、GitHub のプロファイルに反映されます。 長い期間をかけて投稿の記録を作成し、技術ポートフォリオに加えることができます。

コンテンツのフィードバックを送信する方法

Microsoft Learn の多くのドキュメント記事が GitHub リポジトリに保存されていることを思い出してください。 多くの GitHub リポジトリでは、GitHub issue が有効になっています。 有効にすると、 このページ のフィードバックを送信するオプションは、 learn.microsoft.comに関する記事の下部にあります。

ここでは、Microsoft Learn の記事から GitHub に issue を送信する方法について説明します。

1. フィードバックを送信する Microsoft Learn ドキュメントの記事に移動します。

2. 記事の下部にある [フィードバック] という見出しを見つけます。 [ このページは役に立ちましたか?] という質問の横に、[ はい ] と [ いいえ] のボタンがあります。 ボタンを選択して、記事が役に立ったかどうかを示します。 これにより、コメントに入力できるフォームが開きます。

3. フィードバックの理由を選択します。

4. 次のテキスト ボックスで、フィードバックを説明し、必要なコンテキストを指定します。

5. 完了したら、[ 送信] を選択します。

問題を送信すると、記事の作成者または他のコンテンツ所有者に通知されます。