Skip to content

docs(design-principles): 不要なセカンダリラベルや説明を避け、レイアウトに説明させるルールを追加 - #26

Merged
tkc310 merged 1 commit into
mainfrom
docs/principle-let-layout-explain
Oct 24, 2026
Merged

tkc310 merged 1 commit into
mainfrom
docs/principle-let-layout-explain

Conversation

@tkc310

@tkc310 tkc310 commented Oct 23, 2026

Copy link
Copy Markdown
Owner

変更内容

design-principles の原則「削る」に、部品を組み合わせたページで適用するルールを追加しました(既存の「削る」は「主タスクに不要な説明を置かない」までで、重複したラベルとレイアウトで伝える点は書かれていませんでした)。

必須

  • 見出し・配置・まとまりで既に伝わることを、セカンダリラベル(小見出し、見出しの上の補助ラベル、項目名の前置き)や説明文で繰り返さない
  • 項目どうしの関係(グループ、主従)はレイアウト(近さ・並び・枠や背景・大きさの差)で示し、説明文で補わない
  • 削ってよいのは重複した表示だけ。入力欄の見えるラベル(WCAG 3.3.2)、見出しや表の見出しセル(1.3.1)、アイコンだけの操作の名前は残す。見た目のグループには fieldset/legend や区画の見出しで名前を付ける

推奨: 補足文が要りそうなら、先に配置・見出しの段・ラベルの語を直す。補足は形式や制約など見た目から分からないことに使う

あわせて、出典カタログ(ゲシュタルトの近接・共通地域の吸収先)、ルールブック 01(対応表)・05(supportText をラベルの言い換えに使わない)、DESIGN.md の Don't に反映しました。特化ルール(社内向けツールの「まれな手続きには説明を残す」など)とは、優先順位どおり特化ルールが勝つので矛盾しません。既存のストーリーの補足文はすべて制約・形式を伝えるもので、違反はありませんでした。

Storybook プレビュー

なし(文書のみ)

完了の定義

  • PR のタイトルが Conventional Commits の形式
  • make check と make test が通る(CI で確認)
  • changeset を追加した(公開パッケージは変更なしのため不要)
  • ライト / ダークの両方で見た目を確認した(見た目の変更なし)
  • キーボードで操作でき、フォーカス表示が見える(該当なし)
  • 新しい semantic カラーを足した場合 → 追加なし
  • 値や方針を変えた場合、docs/decisions/ に ADR を足した(原則の追記のみで不要)

改善ループ

  • docs/improvement/log.md に 1 行追記した
  • 再発防止として追加したもの: 原則のレビュー項目 3 件(design-review で確認される)

Generated by Claude Code

原則「削る」に、部品を組み合わせたページで適用するルールを追加した。

- 必須: 見出し・配置・まとまりで伝わることを、小見出し・補助ラベル・説明文で繰り返さない
- 必須: 項目どうしの関係(グループ・主従)はレイアウトで示し、説明文で補わない
- 必須: 削るのは重複した表示だけ。入力欄の見えるラベル(WCAG 3.3.2)と構造(1.3.1)、アイコンだけの操作の名前は残す
- 推奨: 補足文が要りそうなら、先に配置・見出し・ラベルの語を直す
- 出典カタログ(ゲシュタルトの近接・共通地域)、ルールブック 01・05、DESIGN.md の Don't に反映

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Yb44feYKDNj2ukQeT2j8Ks
@tkc310
tkc310 merged commit 625c244 into main Oct 24, 2026
3 checks passed
@tkc310
tkc310 deleted the docs/principle-let-layout-explain branch October 24, 2026 02:15
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