演習 - Microsoft Learn ドキュメント記事に投稿する

  • 4 分

投稿ワークフローを実践してみましょう。 この演習では、Microsoft Learn のオープンソース ドキュメント記事を少し変更します。 次に、pull request を開いて変更を提案します。

記事を編集する

  1. 自分の GitHub アカウントにログインします。

  2. ブラウザー タブで、learn.microsoft.com/contribute/content に移動します。

  3. 記事の上部にある [編集] の鉛筆アイコンを選択します。

    開かれた投稿記事と、強調表示された鉛筆の [編集] アイコンのスクリーンショット。

  4. 鉛筆アイコンを選択して、このリポジトリをフォークしてフォークで編集するか、このプロジェクトのフォークでこのファイルを編集します。

    ブラウザーで開かれた投稿記事のソース ファイルと、強調表示された [編集] アイコンのスクリーンショット。

  5. GitHub から次のページでリポジトリをフォークするように求められたら、[リポジトリをフォークします] を選択します。

  6. [ファイルの編集] ペインが開きます。 この記事の先頭に新しい文を追加する必要があります。 2 番目の段落の先頭に、次の文を追加します。“Microsoft Learn は、Microsoft 製品とテクノロジに関するすべてのドキュメントをホストします。”

    新しい文で編集された投稿ファイルと、[変更点のコミット] ボタンが強調表示されたスクリーンショット。

PR をオープンする

  1. [プレビュー] タブを選択して、変更をプレビューします。

  2. 変更が完了したら、[変更をコミットする] を見つけて選択します。

  3. [コミット メッセージ] フィールドに「テスト投稿」と入力します。

    「TEST contribution」と入力された [コミット メッセージ] フィールドのスクリーンショット。

  4. [Propose changes] (変更を提案する) を選択します。

  5. [Comparing changes] (変更の比較) ページで、ベースに main が表示されていることを確認します。 これは、変更がライブ リポジトリのメイン ブランチにプルされることを意味します。

    Base が Main であること (つまり変更が main ブランチにマージされること) を確認するページのスクリーンショット。

    Note

    このページに base repository と head repository のオプションが表示されない場合は、[compare across forks] (フォーク間で比較) を選択します。 この手順に必要な比較オプションが表示されます。

  6. [Pull request の作成] ボタンを選択します。

  7. これにより、[Open a pull request] (pull request を開く) ページが表示され、ここで pull request (PR) をプレビューできます。

  8. PR を確認し、[Pull request の作成] を選択して PR を開きます。

    開かれた PR のスクリーンショット。

Note

これは練習として行った演習であるため、変更はライブ Web サイトにマージされません。

これで PR の作成が完了しました。 まだ送信されていませんが、投稿の最初の主要な手順を完了しました。 ブラウザーで [PR] タブを開いたままにします。 これは次の演習でも使います。