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