GitHub Codespaces について
GitHub Codespaces を使用すると、自分のコンピューターから、リモートでホストされている開発環境で作業できます。 作業環境を設定したり、ローカル コンピューターにファイルをダウンロードしたりしなくても、すぐに作業を開始できます。
詳しくは、「GitHub Codespaces の概要」を参照してください。
codespace でのドキュメントの操作
次の手順は、Web 用 Visual Studio Code を使用してファイルを編集するように GitHub Codespaces が設定されていることを前提としています。 別のエディターを設定した場合、手順はよく似ています。 詳しくは、「GitHub Codespaces の既定のエディターを設定する」を参照してください。
-
GitHub Docs のオープンソース リポジトリ
github/docsに移動します。 -
オープンソース共同作成者の場合は、リポジトリのフォークを作成し、フォークからこの手順の残りの手順に従います。 詳しくは、「リポジトリをフォークする」を参照してください。
-
作業するためのブランチを作成します。 詳しくは、「リポジトリ内でブランチを作成および削除する」を参照してください。
-
リポジトリのメイン ページで、 [ コード] をクリックし、 [BRANCH-NAME に codespace を作成する] をクリックします。
[codespace の設定] ページが表示されます。 しばらくすると、ブラウザーベースのバージョンの Visual Studio Code が表示されます。
-
エクスプローラーを使用して、編集するマークダウン ファイルに移動します。 ファイルがアーティクルの場合は、
contentディレクトリに配置されます。 ファイルが再利用可能なコンテンツである場合は、dataディレクトリに配置されます。ほとんどの場合、
contentディレクトリ内のアーティクルへのパスは、URL 内のパスから.mdファイル拡張子を引いたものと一致します。 たとえば、アーティクルhttps://docs.github.com/en/codespaces/getting-started/quickstartのソースはマークダウン ファイルcontent/codespaces/getting-started/quickstart.mdです。 -
必要に応じてマークダウン ファイルを編集します。
-
変更を保存します。
-
ソース管理ビューを使用するか、ターミナルから Git コマンドを使用して、変更をコミットしてプッシュします。 詳しくは、「Git について」を参照してください。
pull request の作成
-
github.com/github/docs/pulls で、
github/docsリポジトリの [pull request] タブに移動します。 -
[新しい pull request] をクリックします。
-
オープンソース共同作成者の場合は、 [フォーク間の比較] をクリックし、作成したフォークされたリポジトリと、作業ブランチを選びます。
それ以外の場合は、"compare" ブランチを自分の作業ブランチに変更します。
-
表示された変更に、codespace で行ったすべての変更が含まれることを確認します。 そうでない場合は、codespace から GitHub にプッシュしていない変更があることを示している可能性があります。
-
[pull request の作成] をクリックします。
-
pull request の詳細を入力し、 [pull request の作成] をクリックします。
pull request は、GitHub Docs チームのメンバーによってレビューされます。