ドキュメント用のローカル Git リポジトリの設定

この記事では、アドビのドキュメントにコントリビューションするためにローカルマシン上に Git リポジトリを設定する手順について説明します。コントリビューターは、ローカルに作成したクローンのリポジトリを使用して、新規記事の追加、既存記事に対する大きな編集、アートワークの変更をおこなうことができます。

概要

アドビのドキュメントにコントリビューションするには、読み取り／書き込み権限を取得するために、適切なリポジトリを自身の GitHub アカウントにフォークします。その後、対応するドキュメントリポジトリのクローンを作成して、ローカルで Markdown ファイルを作成および編集することができます。作業が終わったら、プルリクエストを使用して、変更を中央の読み取り専用共有リポジトリにマージ（提出）します。

リポジトリを特定

変更案を保存するための読み取り／書き込み権限を取得するには、適切なリポジトリを自身の GitHub アカウントにフォークします。Adobe Experience Cloud のドキュメントは、github.com の複数のリポジトリーにあります。

アドビのドキュメントにコントリビューションするには、対応するドキュメントリポジトリのクローンを作成して、Markdown ファイルをローカルで作成および編集します。作業が終わったら、プルリクエストを使用して、変更を中央の読み取り専用共有リポジトリにマージします。

リポジトリをフォーク

適切なリポジトリを使用し、そのリポジトリを GitHub の Web サイトから自身の GitHub アカウントにフォークします。

個人用のフォークが必要になるのは、メインのドキュメントリポジトリはいずれも読み取り専用で、リポジトリのコンテンツを直接変更することはできないからです。コンテンツを変更するには、フォークからメインリポジトリへのプルリクエスト（PR）を提出しなければなりません。このプロセスを進めるために、まずリポジトリの作業用コピーを作成して、書き込みアクセスを可能にする必要があります。そのために、GitHub の​ フォーク ​を使用します。

リポジトリのローカルクローンを作成

フォークされたリポジトリのクローンを作成することで、自分のコンピューターにファイルのコピーをダウンロードできます。編集が終わったら、編集内容をローカルドライブからサーバー上のフォークされたリポジトリにプッシュできます。その後、プルリクエストを提出して、upstream のメインリポジトリに編集をマージできます。

以下の手順では、GitHub Desktop の使用を想定しています。別のクライアントを使用している場合は、適宜読み替えてください。

詳しくは、GitHub Desktop のドキュメントを参照してください。