Skip to content

docs: README を repo-readme の型に合わせ、である調に揃える - #68

Merged
yktsnet merged 1 commit into
mainfrom
docs/readme-style
Sep 29, 2026
Merged

yktsnet merged 1 commit into
mainfrom
docs/readme-style

Conversation

@yktsnet

@yktsnet yktsnet commented Sep 29, 2026

Copy link
Copy Markdown
Owner

概要

#67 の README は ですます調で、repo-readme の Type A の下限(コアメッセージの形・技術選定の Why)も満たしていなかった。構成と内容は #67 のまま、型に合わせて直す。

変更

  • 文体: 地の文をである調に揃える(背景の節はもともと である調)
  • コアメッセージ: H1 直下を「本リポジトリは」で始め、何を実証するか(規則を環境に置く形)と手段(Nix・deny とフック・skill)を1文に入れる
  • Tech Stack: | Layer | Technology | Reason | の表を足す
  • 図: Deciding and Building に、ローカルとリモートの境界と issue-abort の分岐を示す図を足す。実行者がリモートへ出る経路を持たない点を図で示す(mermaid-diagram の「境界」「分岐」に当たる)
  • 動かす手順: 載せない理由を What Is Not Here に一言足す
  • 英語版も同じ変更を入れる

検証手順

  • GitHub 上で Mermaid 図が本文幅に収まって描画されること
  • README に ですます調の文末が残っていないこと

- 地の文をである調に揃える
- H1 直下のコアメッセージを「本リポジトリは」で始め、何を実証するかと手段を1文に入れる
- Tech Stack 節を Reason 列つきで足す
- 役割の分離に、ローカルとリモートの境界と abort の分岐を示す図を足す
- 動かす手順を載せない理由を What Is Not Here に書く
@yktsnet
yktsnet merged commit 233aa41 into main Sep 29, 2026
4 checks passed
@yktsnet
yktsnet deleted the docs/readme-style branch September 29, 2026 12:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant