真新しいソフトウェアプロジェクトを始めるにせよ、GitHub で「Documentation-as-Code」方式のドキュメントを作成するにせよ、最初のステップはリポジトリ (repo) を作成することです。その方法をご紹介します。

なぜgithub repoを作成するのか？

Gitはオープンソースの分散型バージョン管理システムで、複数の開発者（とライター!）を使えば、他の人の仕事を書き換えることなく、常に継続的に変更を加え、コードやドキュメントを一元的に追跡することができます。このバージョン管理により、問題が発生した場合、その根本原因を簡単に見つけることができ、問題のコードをプッシュアウトする前に作業バージョンに戻すことができます。

また、誰がいつ、何に貢献したかを記録することができます。これは、異なるタイムゾーンから複数の人がプロジェクトに参加する場合に特に重要です。

関連：GitHubとは何か、何に使うのか？

GitHub リポジトリを作成することで、これらのメリットをプロジェクトにもたらすことができます。さらに、レポを公開すれば、壊れたコードの修正や誤字脱字の訂正など、他の人が助けてくれることもあります。事前にベータ版を公開することも可能です。オープンソースは素晴らしいものです。

githubレポの作成方法

GitHubでプロジェクトを立ち上げるには、レポを作成する必要があります。これを行うには、GitHubのアカウントにログイン（または作成）します。ログイン後、ヘッダーメニューの右側にある「＋」アイコンをクリックします（サイト内のどこからでもアクセスできます）。表示されるドロップダウンメニューで、「新規リポジトリ」を選択します。

これで、「新しいリポジトリの作成」ページに移動します。レポのオーナーを選び、短く覚えやすい名前をつけます。レポ契約の名称は、URL フレンドリーでなければならないことを忘れないでください。厳密な決まりはありませんが、最も一般的なのは、すべて小文字で、ハイフンで単語を区切る方法です（例：example repo name）。

レポに名前をつけたら、簡単な説明をつけ、レポを公開するか非公開にするかを選択します。

次にできること。

• Readmeファイルの追加：プロジェクトの使い方や貢献の仕方について紹介・説明します。
• Add.gitinore：無視するファイルを選択します。
• ライセンスの選択：あなたのプロジェクトのコードで何ができて、何ができないかを他の人に知らせることができます。

準備ができたら、"Create Repository" をクリックします。

これで、あなたのレポが作成されました。

一度作成したレポは、ローカルコンピューターにクローンすることができますので、レポ内のソースファイルを直接編集するのではなく、ローカルで内容を編集することができます。

関連：GitHubのリポジトリをクローンする方法