Skip to content

docs: Step 2 shared visual design - #18

Merged
VolkerChristian merged 3 commits into
mainfrom
polish/step2-visual
Oct 12, 2026
Merged

VolkerChristian merged 3 commits into
mainfrom
polish/step2-visual

Conversation

@VolkerChristian

@VolkerChristian VolkerChristian commented Oct 12, 2026 •

Copy link
Copy Markdown
Member

Step 2 items

2.1, 2.4, 2.5

No merge, tag or repository-setting changes. No CI dispatch in Step 2; the Step 1 documentation-only publication was separately authorized and completed. Existing caller/template refs already use @main and are unchanged (item 2.6 was superseded). Typography and glyphs are generated by the single shared renderer. GitHub gate passed before rollout at 390/1440 px in both themes: three specified source elements per right button plus fallback img survive, correct intrinsic 36×28 / 160×28 sizes, same-row phone geometry and unchanged desktop box sizes (including native GitHub padding).

Files

  • README.md
  • docs/media/nav/organization-dark.svg
  • docs/media/nav/organization-light.svg
  • navigation/README.md
  • navigation/plan.yml
  • profile/media/menu/applications.svg
  • profile/media/menu/community.svg
  • profile/media/menu/framework.svg
  • profile/media/menu/infrastructure.svg
  • profile/media/menu/learn.svg
  • profile/media/menu/suites.svg
  • tests/test_navigation.py
  • tools/snodec_sync/navigation.py

Verification

  • python3 -m unittest discover -s tests -v: 68 passed.
  • python3 <control checkout>/tools/snodec_sync docs-audit --repo <checkout>: 0 violations.
  • python3 <control checkout>/tools/snodec_sync page-headers --repo <checkout> --check: passed.
  • git diff --check: passed. No tests weakened; new shapes replace the old geometry assertion to match the approved spec.

Final visual review

Public native-GitHub review covered 40 page/width/theme cases, plus the initial snode.c gate and final full-width root captures: no broken images. Intrinsic desktop heroes are 1280×320; new phone heroes are 640×372, and the existing snode.c/MQTTSuite phone SVGs are byte-identical. All remaining title menus are normalized to 160×28, including the source-build Native Linux/OpenWrt menus; full meaning remains in alt/title text.

Native wrapping limitations remain explicit: five-column status tables overflow horizontally on phones; DistributionPackages’ long H1 wraps naturally; legend symbols can detach from labels at 390px. A word-joiner was measured ineffective and removed; no CSS fallback, table navigation redesign or palette/shape rollback was introduced.

Final verification

Optional docs-audit: 0 violations at the edited/exported boundary. page-headers --check: passed. Staged/final diff checks: passed. No Step 2 merge or publication has occurred.

@VolkerChristian
VolkerChristian merged commit 6b7c282 into main Oct 12, 2026
2 checks passed
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