Skip to content

docs: Step 1 navigation and link polish - #17

Merged
VolkerChristian merged 1 commit into
mainfrom
polish/step1-navigation
Oct 12, 2026
Merged

VolkerChristian merged 1 commit into
mainfrom
polish/step1-navigation

Conversation

@VolkerChristian

Copy link
Copy Markdown
Member

Step 1 — addressed items

1.1, 1.2, 1.3, 1.4.7, 1.5.1–2, 1.6. Also the later explicit agreement to use verify.yml@main for callers/template; no tag release is needed.

Buttons remain only in marked header/root-organization/title-menu blocks; inner routes and onward links become text, preserving their destinations. Menu assets use the existing shared _menu_svg renderer and its read-only drift mode.

Files

  • README.md
  • navigation/README.md
  • navigation/plan.yml
  • profile/README.md
  • 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
  • templates/ci.yml
  • templates/readme-frame.md
  • tests/test_docs_audit.py
  • tests/test_navigation.py
  • tests/test_verify.py
  • tools/snodec_sync/__main__.py
  • tools/snodec_sync/docs_audit.py
  • tools/snodec_sync/navigation.py

The audit is optional local/PR tooling only. It restores the single prior parser, adds f/g/h and section-list opt-out, retains narrow published-output/media-note declarations, and is not invoked by Verify or publication. Existing v1.0–v1.3 tags stay unchanged.

Converted links

File Old button New text Unchanged target

Asset renames

Old New
profile/media/menu/applications-108.svg profile/media/menu/applications.svg
profile/media/menu/community-108.svg profile/media/menu/community.svg
profile/media/menu/framework-108.svg profile/media/menu/framework.svg
profile/media/menu/infrastructure-108.svg profile/media/menu/infrastructure.svg
profile/media/menu/learn-108.svg profile/media/menu/learn.svg
profile/media/menu/suites-108.svg profile/media/menu/suites.svg

Deleted assets

Verification commands and results

  • python3 -m unittest discover -s tests -v: 66 passed.
  • python3 tools/snodec_sync check: passed.
  • Fresh profile render compared with checked-in output: byte-identical.
  • python3 <control checkout>/tools/snodec_sync docs-audit --repo .: 0 violations (f/g/h included).
  • python3 <control checkout>/tools/snodec_sync page-headers --repo . --check: passed.
  • git diff --cached --check: passed. No CI dispatched, settings changed, tags changed, licences/forks touched, or branches renamed.

@VolkerChristian
VolkerChristian merged commit dad7e28 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