タグ

ブックマーク / qiita.com/autotaker1984 (1)

  • イケてるレポジトリのREADME.mdには何を書くべきか - Qiita

    はじめに GitHubでレポジトリを作成すると最初に作成されるREADME.md。 デフォルトのまま放置していたりしませんか? README.mdはレポジトリの顔です。 ここを整えておくことで、レポジトリのクオリティをぐっと上げることができます。 しかし、README.mdに何を書いたらいいのか、わからないという人も多いと思います。 この記事ではおすすめの構成をまとめます。 README.mdの読者はだれか? まず、誰に向けてREADME.mdを書くのかというところから考えることから始めましょう。 README.mdの読者は大きく分けてユーザと開発者の2種類います。そのレポジトリを閲覧するひとはユーザが多いのか、開発者が多いのかを想定してどちらをメインで書くか決めると良いでしょう。 README.mdは英語で書くべき? 有名OSSはすべて英語でREADME.mdが書かれているため、当然英語

    イケてるレポジトリのREADME.mdには何を書くべきか - Qiita
  • 1