== Background
While a short overview [[ https://www.mediawiki.org/w/index.php?title=Manual:How_to_make_a_MediaWiki_skin&oldid=5919516 | has been provided on mediawiki.org ]] when Codex tokens became the source for skin variables in April, the documentation is lacking depth.
== Goal
Ensure that the documentation has a clear overview
- why this source of truth is so powerful for MediaWiki interface authors
- why it's advantageous to have one source of truth
- how to customize them to team specific needs
- what's the connex to Codex, the design system for Wikimedia and how to connect
I've provided a diagram for a better overview:
{M332}
It features our three “WikimediaUI” based skins, Timeless for another Wikimedia deployed one, and two exemplary skins beyond.
The tokens and vars provided are representations for the functionality, not always 1:1 values.
One missing piece is, that skin.defaults are meant to be oriented on pure HTML looks with usability/accessibility in mind.
== Acceptance criteria
[] Expand the documentation to represent above points and reach out internally and externally on clarity. Based on feedback: amend.
[x] Update [[ https://www.mediawiki.org/w/index.php?title=Vue.js%2FGuidelines&diff=6166110&oldid=6157288 | Vue.js guidelines on mediawiki.org ]] for design tokens usage