次の方法で共有

このドキュメントに投稿する

このドキュメントをご感心をお寄せいただき、ありがとうございます。

GitHub を使用して投稿する

リポジトリをデスクトップに複製せずにこのドキュメントに投稿するには、GitHub を使用します。 これは、このリポジトリでプル リクエストを作成する最も簡単な方法です。 コードの変更に関係しない小さな変更を加えるには、この方法を使用します。 このメソッドを使用すると、一度に 1 つの記事に投稿できます。

GitHub を使用して投稿するには

  1. 投稿する記事を GitHub で検索します。
  2. GitHub で記事が表示されたら、GitHub にサインインします (無料アカウントを取得するには、「Join GitHub」 (GitHub に参加) にアクセスします)。
  3. 鉛筆アイコン (このプロジェクトのフォーク内のファイルを編集) を選択し、[ファイルの編集] ウィンドウで変更<>します。
  4. 一番下までスクロールし、説明を入力します。
  5. [ファイル変更の提案] > [プル リクエストの作成] を選択します。

これでプル リクエストを正常に提出できました。 プル リクエストは、通常 10 営業日以内に審査されます。

Git を使用して投稿する

次のような実質的な変更を投稿するには、Git を使用します。

  • コードの投稿。
  • 意味に影響する変更の投稿。
  • テキストの大規模な変更の投稿。
  • 新しいトピックの追加。

Git を使用して投稿するには

  1. GitHub アカウントを持っていない場合は、GitHub でセットアップします。

  2. アカウントを取得したら、コンピューターに Git をインストールします。 [Git のセットアップ] チュートリアルの手順に従います。

  3. Git を使用してプル リクエストを提出するには、「GitHub、Git、およびこのリポジトリを使用する」の手順を実行します。

  4. 次の場合は、共同作成者の使用許諾契約書に署名するように求められます。

    • Microsoft Open Technologies グループのメンバーである
    • Microsoft の従業員でない投稿者である

コミュニティ メンバーは、プロジェクトへの大規模な投稿を行う前に投稿者のライセンス同意書 (CLA) に署名する必要があります。 このドキュメントに記入して送信する必要があるのは 1 回だけです。 注意深く確認してください。 雇用主がこのドキュメントに署名することが要求される場合もあります。

CLA への署名により、メイン リポジトリにコミットする権限が付与されるわけではありませんが、Office Developer および Office Developer Content Publishing チームからお客様の投稿への確認と承認を受けることができるようになります。 送信内容には自身の名義が入ります。

通常、プル要求は 10 営業日以内に審査されます。

GitHub、Git、およびこのリポジトリを使用する

注:

このセクションのほとんどの情報は、[GitHub ヘルプ] の記事で確認できます。 Git と GitHub のことをよく知っている場合は、「コンテンツを投稿して編集する」のセクションまでスキップして、このリポジトリのコード / コンテンツ フローの詳細を参照してください。

リポジトリのフォークをセットアップするには

  1. このプロジェクトに投稿できるように、GitHub のアカウントをセットアップします。 まだ行っていない場合は、今すぐ GitHub にアクセスしてセットアップします。

  2. Git をコンピューターにインストールします。 [Git のセットアップ] チュートリアルの手順に従います。

  3. このリポジトリの独自のフォークを作成します。 これを行うには、ページの上部にある [フォーク] ボタンを選択します。

  4. フォークをコンピューターにコピーします。 これを行うには、Git Bash を開きます。 コマンド プロンプトで、次のように入力します。

    git clone https://github.com/<your user name>/<repo name>.git

  5. Next, create a reference to the root repository by entering these commands:

        cd <repo name>
        git remote add upstream https://github.com/OfficeDev/<repo name>.git
        git fetch upstream

おめでとうございます。 リポジトリをセットアップできました。 今後、同じ手順をもう一度繰り返す必要はありません。

コンテンツを投稿して編集する

投稿プロセスをできるだけシームレスにするため、以下の手順に従ってください。

コンテンツを投稿して編集するには

  1. 新しい分岐を作成します。
  2. 新しい内容を追加するか、既存の内容を編集します。
  3. メイン リポジトリにプル リクエストを提出します。
  4. 分岐を削除します。

重要: 各ブランチを単一の概念/アーティクルに制限して、作業フローを合理化し、マージ競合の可能性を減らします。 新しい分岐に適した内容には、次のものが含まれます。

  • 新しい記事。
  • スペルと文法の編集。
  • 大規模な記事セット全体への単一の書式設定変更の適用 (たとえば、新しい著作権フッターの適用)。

新しい分岐を作成するには

  1. Git Bash を開きます。
  2. At the Git Bash command prompt, type git pull upstream main:<new branch name>. これにより、最新の OfficeDev メイン ブランチからコピーされた新しいブランチがローカルに作成されます。
  3. At the Git Bash command prompt, type git push origin <new branch name>. This alerts GitHub to the new branch. You should now see the new branch in your fork of the repository on GitHub.
  4. At the Git Bash command prompt, type git checkout <new branch name> to switch to your new branch.

新しい内容を追加するか既存の内容を編集する

You navigate to the repository on your computer by using File Explorer. The repository files are in C:\Users\<yourusername>\<repo name>.

ファイルを編集するには、好みのエディターで開いて変更します。 新しいファイルを作成するには、好みのエディターを使用して、リポジトリのローカル コピー内の適切な場所に新しいファイルを保存します。 作業中は、頻繁に作業内容を保存してください。

The files in C:\Users\<yourusername>\<repo name> are a working copy of the new branch that you created in your local repository. Changing anything in this folder doesn't affect the local repository until you commit a change. To commit a change to the local repository, type the following commands in GitBash:

    git add .
    git commit -v -a -m "<Describe the changes made in this commit>"

add コマンドは、変更をリポジトリにコミットする準備としてステージング領域に追加します。 add コマンドの後の期間は、サブフォルダーを再帰的にチェックして、追加または変更したすべてのファイルをステージングすることを指定します。 (すべての変更をコミットしない場合は、特定のファイルを追加できます。コミットを元に戻すこともできます。ヘルプについては、「 git add -help 」または「 git status」と入力します)。

commit コマンドにより、ステージングされた変更がリポジトリに適用されます。 スイッチ -m は、コミット コメントをコマンドラインで提供することを意味します。 -v および -a スイッチは省略できます。 -v スイッチはコマンドからの詳細 (verbose) 出力用で、-a スイッチは add コマンドですでに行ったことを行います。

作業の途中で複数回コミットするか、完了時に 1 回コミットすることができます。

メイン リポジトリにプル リクエストを送信する

作業が完了し、メイン リポジトリにマージする準備ができたら、以下の手順を実行します。

メイン リポジトリにプル リクエストを送信するには

  1. In the Git Bash command prompt, type git push origin <new branch name>. In your local repository, origin refers to your GitHub repository that you cloned the local repository from. This command pushes the current state of your new branch, including all commits made in the previous steps, to your GitHub fork.
  2. GitHub サイト上のフォーク内で、新しい分岐まで移動します。
  3. ページの上部にある [プル リクエスト] ボタンを選択します。
  4. Verify the Base branch is OfficeDev/<repo name>@main and the Head branch is <your username>/<repo name>@<branch name>.
  5. [コミット範囲の更新] ボタンを選択します。
  6. プル リクエストにタイトルを追加し、作成しているすべての変更についての説明を入力します。
  7. プル リクエストを提出します。

One of the site administrators will process your pull request. pull request は、OfficeDev/repo 名 サイトの [Issue]\(問題\) の下に表示されます。 When the pull request is accepted, the issue will be resolved.

マージの後に新しい分岐を作成する

分岐が正常にマージされた (つまり、プル リクエストが承諾された) 後は、ローカル分岐で作業を継続しないでください。 別のプル リクエストを提出する場合にマージの競合が発生する可能性があります。 別の更新を行うには、正常にマージされたアップストリーム分岐から新しいローカル分岐を作成した後、最初のローカル分岐を削除します。

たとえば、ローカル ブランチ X が OfficeDev/microsoft-graph-docs メイン ブランチに正常にマージされ、マージされたコンテンツを追加で更新する場合です。 OfficeDev/microsoft-graph-docs メイン ブランチから新しいローカル ブランチ X2 を作成します。 これを行うには、GitBash を開き、次のコマンドを実行します。

    cd microsoft-graph-docs
    git pull upstream main:X2
    git push origin X2

ブランチ X で提出した作業のローカル コピー (新しいローカル ブランチ内) が作成されました。X2 ブランチには、他のライターがマージしたすべての作業も含まれているため、作業が他のユーザーの作業 (共有イメージなど) に依存している場合は、新しいブランチで使用できます。 新しいブランチをチェックアウトすることで、以前の作業 (および他のユーザーの作業) がブランチ内にあることを確認できます。

git checkout X2

...and verifying the content. (The checkout command updates the files in C:\Users\<yourusername>\microsoft-graph-docs to the current state of the X2 branch.) Once you check out the new branch, you can make updates to the content and commit them as usual. However, to avoid working in the merged branch (X) by mistake, it's best to delete it (see the following Delete a branch section).

分岐を削除する

変更内容がメイン リポジトリにマージされたら、使用した分岐は不要になったので削除します。 追加の作業は新しい分岐で行う必要があります。

  1. Git Bash のコマンド プロンプトで、「git checkout main」と入力します。 これにより、削除される分岐にいないことが保証されます (削除される分岐にいることは許可されません)。
  2. Next, at the command prompt, type git branch -d <branch name>. This deletes the branch on your computer only if it has been successfully merged to the upstream repository. (You can override this behavior with the –D flag, but first be sure you want to do this.)
  3. Finally, type git push origin :<branch name> at the command prompt (a space before the colon and no space after it). This will delete the branch on your github fork.

おめでとうございます。プロジェクトに正しく投稿できました。

Markdown を使用してトピックの書式を設定する

Markdown

このリポジトリ内のすべての記事では、Markdown を使用しています。 完全な概要 (およびすべての構文の一覧) は、[Daring Fireball - Markdown] にあります。

このリポジトリ専用の規則 & マークアップ規則

共同作成者ガイドの Docs Markdown リファレンスを参照 してください。

FAQ

GitHub アカウントを取得する方法を教えてください。

無料の GitHub アカウントを開設するには、「Join GitHub」(GitHub に参加) にあるフォームに記入します。

投稿者のライセンス同意書はどこで入手するのでしょうか。

pull request に署名が必要な場合は、共同作成者の使用許諾契約書 (CLA) に署名する必要がある旨の通知が自動的に送信されます。

コミュニティ メンバーは、このプロジェクトへの大規模な投稿を行う前に投稿者のライセンス同意書 (CLA) に署名する必要があります。 このドキュメントに記入して送信する必要があるのは 1 回だけです。 注意深く確認してください。 雇用主がこのドキュメントに署名することが要求される場合もあります。

私が投稿した内容はどうなりますか。

プルリクエストを介して変更を送信すると、チームに通知が送信され、プルリクエストが確認されます。 GitHub から pull request に関する通知を受け取ります。さらに情報が必要な場合は、チームの誰かから通知を受け取ることもできます。 pull request が承認された場合は、ドキュメントを更新します。 当社は、法的、スタイル、明確さ、またはその他の問題について、提出物を編集する権利を留保します。

このリポジトリの GitHub プル リクエストの承認者になることができますか。

現在、外部の投稿者がこのリポジトリ内のプル リクエストを承認することは許可されていません。

変更リクエストに関する応答をどのくらいの期間内に受けることができますか。

プル リクエストは、通常 10 営業日以内に審査されます。

その他のリソース

  • Markdown の詳細については、Markdown 作成者のサイト [Daring Fireball] にアクセスしてください。
  • Git と GitHub の使用方法の詳細については、まず [GitHub ヘルプ] をチェックします。

GitHub ホームGitHub ヘルプGitDaring Fireball のセットアップ - MarkdownDaring Fireball

  • Last updated on