リポジトリを開いたら「Add a README」が出ていて、作った README が表示されない…。
よくある原因と、最短で直す手順を Qiita 用にまとめました。

症状

▪️ リポジトリのトップに README が表示されない

▪️ 代わりに “Add a README” のボタンが出ている

▪️ サブディレクトリ（例：src/README.md）には README がある

原因（結論）

GitHub は「リポジトリ直下（ルート）」の README だけを自動表示する。

サブフォルダ内の README（例：src/README.md）は、そのフォルダに入ったときだけ表示されます。

ルートに移動する

# 例: src/README.md をルートへ移動
git mv src/README.md README.md
git commit -m "docs: move README to repository root"
git push origin main