ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。
記事のバージョン: GitHub.com

READMEについて

リポジトリにREADMEファイルを追加して、そのプロジェクトがなぜ有益なのか、そのプロジェクトで何ができるか、そのプロジェクトをどのように使えるかを他者に伝えることができます。

README ファイルは、リポジトリのライセンスコントリビューションガイドライン行動規範と合わせて、プロジェクトへのコントリビューションに対する期待を示し、管理するのに役立ちます。

多くの場合、READMEはリポジトリへの訪問者が最初に目にするアイテムです。 通常、README ファイルには以下の情報が含まれています:

README ファイルをリポジトリのルート、docs、または隠れディレクトリ .github に置けば、GitHub はそれを認識して自動的に README をリポジトリへの訪問者に提示します。

github/scientistリポジトリのメインページとそのREADMEファイル

多くのプロジェクトは、README の先頭にある目次を使ってユーザをファイル中のさまざまなセクションへ誘導します。 セクションのヘッディングにカーソルを置いてリンクを表示させれば、表示されたファイル中のセクションに直接リンクできます。

github/scientist リポジトリ用の README ファイル中のセクションリンク

表示されたファイル中に相対リンクや画像パスを定義すると、読者はリポジトリ中の他のファイルにアクセスしやすくなります。

相対リンクは、現在のファイルに対して相対的なリンクです。たとえば README ファイルがリポジトリのルートにあり、他のファイルを docs/CONTRIBUTING.md に持っている場合は、README 内での CONTRIBUTING.md への相対リンクは以下のようになります:

[このプロジェクトへのコントリビューションガイドライン](docs/CONTRIBUTING.md)

GitHub は、自動的に相対リンクあるいは画像パスを現在のブランチに基づいて変換するので、リンクやパスは常にうまく働きます。./../ といったすべての相対リンクのオペランドが利用できます。

相対リンクは、リポジトリをクローンするユーザにとっては使いやすいものです。絶対リンクはリポジトリのクローンではうまく働かない場合があります。リポジトリ内の他のファイルを参照する際には、相対リンクを使うことをおすすめします。

参考リンク

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください