Skip to content

docs: move design principles to docs/developer/design - #324

Merged
jeyrb merged 3 commits into
mainfrom
hq/design-principles
Nov 14, 2026
Merged

jeyrb merged 3 commits into
mainfrom
hq/design-principles

Conversation

@jeyrb

@jeyrb jeyrb commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Reworked after your comment. This no longer adds a default file: it moves your existing principles (renamed to design_principles.md in 21e5d9d) to docs/developer/design/design_principles.md, the location the HQ design policy gives, next to the RFCs.

  • All twelve principles are unchanged. The file gains a short intro linking the HQ policies (Home Assistant alignment, which Principle 7 applies) and a closing "How the design changes" section (RFCs, roadmap, release policy).
  • Redirects from developer/principles.md and developer/design_principles.md.
  • Fixes links that still pointed at principles.md after the rename: the developer index, the roadmap, RFCs 0002 and 0006, and quick_start/advanced_concepts.md in English and every translation.

docs/developer/roadmap.md stays where it is. The design policy would put it in docs/developer/design/ too, if you want that as well.

From rhizomatics/hq-private#110.

🤖 Generated with Claude Code

@jeyrb

jeyrb commented Nov 14, 2026

Copy link
Copy Markdown
Contributor Author

Design principles already existed as principles.md, now renamed. Review and update PR

jeyrb and others added 2 commits November 14, 2026 16:38
Moves the existing principles (renamed in 21e5d9d) to the location in the HQ
design policy, replacing the default file, adds redirects from both old paths,
fixes links to the old principles.md (developer index, roadmap, RFCs 0002 and
0006, translations), and adds a pointer to the HQ policies plus how the design
changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jeyrb jeyrb changed the title docs: default design principles docs: move design principles to docs/developer/design Nov 14, 2026
@jeyrb
jeyrb merged commit b45fe28 into main Nov 14, 2026
18 checks passed
@jeyrb
jeyrb deleted the hq/design-principles branch November 14, 2026 16:43
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