Skip to content

docs: add DESIGN.md and rename roadmap Trying to Doing - #136

Merged
PathGao merged 2 commits into
mainfrom
docs/design-roadmap
Oct 10, 2026
Merged

PathGao merged 2 commits into
mainfrom
docs/design-roadmap

Conversation

@PathGao

@PathGao PathGao commented Oct 10, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Add docs/DESIGN.md and its zh-Hans mirror in three parts: glossary, product decisions, visual design. Every entry cites the PR, doc or source file where it was decided; open questions are left out.
  • Rename the roadmap's Trying section to Doing, so the roadmap has the four sections Doing, Planned, Done and Not Do.
  • Remove docs/VISUAL-SYSTEM.md and its mirror. That 2026-08-27 audit was a proposal: its adopted parts are in DESIGN.md, its questions were settled by A hardcoded radius, point size or colour in the panel now fails the build #29 and The panel's controls are the system's again #73, and the last one (window widths) is closed as-is.
  • Record the 2026-10-10 wording decisions in the glossary: site is 网站, Site Gallery is 网站库, Reload is 刷新, and Shortcuts use "Turn … on or off". The string changes are a separate PR.

Verification

Docs only, no build. A local script checked that every relative link in the changed docs resolves, that the English and zh-Hans DESIGN files carry the same IDs and PR references, and that each glossary term exists in Localizable.xcstrings.

DESIGN.md (with zh-Hans mirror) holds the decided glossary, product
decisions and visual rules, each citing its source PR, doc or file.
VISUAL-SYSTEM.md stays for its open window-width question and points
to DESIGN.md.
…ual audit

The audit's last open question (window widths) is closed as-is, so
VISUAL-SYSTEM.md and its mirror are removed and DESIGN.md cites the
PRs instead.
@PathGao
PathGao merged commit 4664345 into main Oct 10, 2026
5 checks passed
@PathGao
PathGao deleted the docs/design-roadmap branch October 10, 2026 11:16
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