Skip to content

docs: give every page a way back to the portal - #289

Merged
Naruto merged 1 commit into
developfrom
docs/link-back-to-the-portal
Aug 26, 2026
Merged

Naruto merged 1 commit into
developfrom
docs/link-back-to-the-portal

Conversation

@Naruto

@Naruto Naruto commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

A reader who arrives on this site from a search had no route onward to SpriteStudio Docs or to the other players. The portal was linked from body text on the home page and nowhere else, so every other page here was a dead end — a poor result for a family of sites whose premise is one shared core behind many players.

This adds it to the site chrome, so it is on every page:

  • mkdocs.ymlmaterial/motion-play → the portal root, first in extra.social, ahead of the GitHub / product / X icons already there
  • mkdocs.ja.yml — same icon → /SpriteStudio-Docs/ja/, so a Japanese reader is not handed the English portal

Every sibling site gets the same icon in the same position, so the affordance is in one place across the family rather than wherever each repo happened to mention it.

Companion to cri-middleware/SpriteStudio-Docs#42, which does the portal-side half.

A reader who arrives here from a search had no route onward to SpriteStudio
Docs or to the other players. The portal was linked from body text on the home
page and nowhere else, so every other page of this site was a dead end - which
is a poor result for a family of sites whose whole premise is one shared core
behind many players.

Add it as the first footer icon, ahead of the GitHub / product / X icons that
were already there, and point the Japanese config at the /ja/ locale rather
than sending a Japanese reader to the English portal. Every sibling site gets
the same icon in the same position.
@Naruto
Naruto merged commit 1880eac into develop Aug 26, 2026
0 of 2 checks passed
@Naruto
Naruto deleted the docs/link-back-to-the-portal branch August 26, 2026 08:12
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