On 08/20/2013 04:27 PM, S Page wrote:
On Mon, Aug 19, 2013 at 12:43 PM, Benoît Evellin <benoit.evellin@wikimedia.fr mailto:benoit.evellin@wikimedia.fr> wrote:
Is there, anywhere, a documentation about the CSS classes used by the EE and E3 projects? This style or the other one: what does the guideline say?
Sadly https://www.mediawiki.org/wiki/Agora has no guideline as to when to use mw-ui-big, mw-ui-primary, mw-ui-constructive, etc.
I've expanded documentation for the mediawiki.ui module at https://www.mediawiki.org/wiki/ResourceLoader/Default_modules#mediawiki.ui
We could split the prescriptive real-world "Do this with current code" from aspirational "We want the experience to be like this" design guide.
In general, I think the documentation should say how things really are. I.E. tell developers how to use the UX libraries to do real work.
If there is a requested change a team intends to work on, it should be added to a bug or issue tracker. That can link to a separate page clearly labelled as "brainstorming" or "proposed"
Matt Flaschen