Volunteer contributor @Dogu has created a great proof-of-concept for generating Codex css-only component markup (see T372759 and https://gerrit.wikimedia.org/r/1058599 for more details). This work touches on a long-standing problem we've had for Codex usage in MediaWiki, namely: how do we want to approach markup-generation for CSS-only components (see T326850 for some background).
Providing some PHP classes in MediaWiki core could allow for developers to benefit from a more user-friendly way of using CSS-only Codex components (our current solution requires that anyone who wishes to use a CSS-only component must copy, paste, and potentially adapt the example markup we provide on our docs site).
However, if we decide to go down this route then we need to be clear about the potential maintenance burden and other requirements of such a solution. We'll need to ensure that the PHP code is updated in tandem with any major Codex markup changes, we may need to revisit some of our current thinking about backwards compatibility and what constitutes a breaking change, etc.
Acceptance Criteria
- The DST engineers (along with any other relevant folks) have met to discuss how we want to move forward with this feature. We should consider the pros, cons, and other considerations (edge cases, etc) of a PHP-based markup generation system for Codex that lives in MW core.
- The decision is recorded in a suitable format (possibly an ADR on the docs site) and published.