[tomio2480]

セルフレビュー実施済み．/security-review は省略した（Markdown のみの差分で，実行コード・CI 設定・権限・依存関係を含まないため）．

概要

リポジトリの Markdown にたまっていた lint 指摘を解消する．
中央テンプレ（tomio2480/github-workflows v2.22.2）の設定で，markdownlint 58 件・textlint 226 件あった．
内容は変えず，表記と構造だけを直して 0 件にする．

本 PR は #18 のブランチを base にした stacked PR である．
main から切ると，README の同じ箇所を #18 と本 PR の両方が触って衝突するためである．
#18 のマージ後に base を main へ付け替える．

対応する Issue はない．#18 のレビューで，既存行の lint 指摘をスコープ外とした残りを扱う．

変更内容

表 1. 指摘の種類ごとの対応

指摘	件数	対応
全角と半角の間・コードやリンクの前後のスペース	160	textlint --fix で自動修正（オプションは中央設定と同じ）
見出し・リスト・コードブロックの前後の空行	51	markdownlint-cli2 --fix で自動修正
コードブロックの言語指定がない	5	text を付けた
句点「．」・である調の要求	53	ファイル先頭のコメントで無効化（方針は後述）
表記ゆれ「プルリクエスト」	4	辞書に従い「Pull Request」へ揃えた
CONTRIBUTING.md の目次のリンク切れ	1	目次を実在の H2 見出しに合わせた
長い文・読点の多い文・助詞の重複・冗長な表現など	10	文を書き換えた

文体と句読点の方針

リポジトリの既存の書き方に合わせる．方針は CLAUDE.md の「ドキュメントの文体」節に記した．

• Markdown の句読点は「、。」で統一する．
• 利用者・開発者向けの手引き（README.md，docs/，CONTRIBUTING.md，examples/**/README.md）は「ですます調」で書く．
• 規律やガイドライン（CLAUDE.md，PHPDEV.md）は「である調」で書く．

中央設定は「である調」と句点「．」を求める．上記と食い違うルールだけを，各ファイル先頭のコメントで無効化した．
文長・助詞の重複・表記ゆれなどの検査は有効なまま残る．

確認

• 中央リポジトリの bin/lint-md.sh --all で，markdownlint・textlint とも 0 件（終了コード 0）．
• 機械修正の差分を確認した．リンク先とコードブロックの中身は変わっていない（コードブロックへの言語名の追加を除く）．

スコープ外

• docs/WINDOWS_FFI_SETUP.md は確認手順で examples/test_ffi.php を案内している．このファイルは .gitignore の対象で，リポジトリに含まれていない．内容の修正にあたるため，本 PR では扱わない．

🤖 Generated with Claude Code

[github-actions]

Lint summary

ツール	この PR の差分	リポジトリ全体
markdownlint	0	0
textlint	0	0

検査対象: Merge b863558 into 2e83ad9（base: 2e83ad9）

指摘はありません．

Actions run: https://github.com/tomio2480/php-serial/actions/runs/39631355859/attempts/1

[tomio2480]

#18 のマージで base ブランチが削除され，本 PR は自動でクローズされた．同じコミットを main から切ったブランチへ cherry-pick し，#20 として作り直した．

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: aa4eee6c-605a-4331-b669-c483b451fe3a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}