Design/Archive/Wikimedia User Interface/User-stories

How would your story help us?
 * A better idea on where to direct our resources to build a UI toolkit that you can and will use
 * Informing how we build a toolkit that fits into your process
 * Understanding what you care about and making sure we address them
 * And generally getting to know how we can work together to bring some consistency with realistic methods around Wikimedia projects.

[//mediawiki.org/w/index.php?title=Talk:UX_standardization/Stories&action=edit&section=new Share your story ]

Example questions to answer:

First, give us some context about you
 * Are you a front or back-end engineer? Or neither?
 * What do you care about most when contributing to Wikimedia projects?
 * What is your typical area of contribution in Wikimedia projects?
 * What do you use when improving Wikimedia projects’ pages with better UI components (buttons, menus, etc)
 * Or if you make gadgets / tools that relate to Wikimedia projects, what do you use for UI components? '

Here are some example questions to get started with:
 * How do you go about looking for a UI component? For example, if you need a button, where do you look for it?
 * Have you heard of OOJS UI, what do you think this it's used for?

If you are more of a technical contributor: 
 * What’s a framework you most use (even outside of Wikimedia)?
 * Do you read documentation, when do you read documentation?
 * What’s an example of a good framework documentation, what did you appreciate about it and what would you want to know more or less of?
 * What’s an example of a poorly documented documentation, what did you not appreciate about it and what would you want to know more or less of?

Ricordisamoa's story
First, give us some context about you
 * Are you a front or back-end engineer? Or neither?
 * Neither.
 * What do you care about most when contributing to Wikimedia projects?
 * Information must be organized efficiently and without redundancy.
 * What is your typical area of contribution in Wikimedia projects?
 * Writing bots, gadgets, user scripts, Lua modules, external tools; notifying communities of software changes affecting them; reporting communities' needs to developers; keeping mailing lists thriving; contributing small patches via Gerrit and GitHub.
 * What do you use when improving Wikimedia projects’ pages with better UI components (buttons, menus, etc)
 * MediaWiki UI, for example with this edit.
 * Or if you make gadgets / tools that relate to Wikimedia projects, what do you use for UI components?
 * I try to integrate gadgets and scripts with the existing UI as much as I can. At first I used jQuery UI, as in c:User:Ricordisamoa/ShouldBeSVG.js. Then I discovered OOjs UI, and I'm using it for it:Utente:Ricordisamoa/PDC.js.

Here are some example questions to get started with:
 * How do you go about looking for a UI component? For example, if you need a button, where do you look for it?
 * When using native HTML elements, I look at MDN; when using a framework, I look at its documentation and existing code.
 * Have you heard of OOJS UI, what do you think this it's used for?
 * I know it's being used more and more for MediaWiki's UI, but I haven't heard of it outside of Wikimedia.

If you are more of a technical contributor:  -- Ricordi  samoa  23:50, 11 August 2015 (UTC)
 * What’s a framework you most use (even outside of Wikimedia)?
 * As many other projects on Tool Labs, I often use Bootstrap.
 * Do you read documentation, when do you read documentation?
 * I read it frequently, mostly examples.
 * What’s an example of a good framework documentation, what did you appreciate about it and what would you want to know more or less of?
 * Bootstrap is fairly documented: basic examples and many unofficial sites. OOjs UI's documentation is extensive as well, but: this one with static images appears outdated; [//doc.wikimedia.org/oojs-ui/master/js/ this one] seems to assume some previous knowledge of the framework; [//doc.wikimedia.org/oojs-ui/master/demos/ live demos] are nice but don't show the underlying code. See also T97264.
 * What’s an example of a poorly documented documentation, what did you not appreciate about it and what would you want to know more or less of?
 * I find Wikibase Repo's GUI poorly documented (T95649).

Halfak's story
First, give us some context about you
 * Are you a front or back-end engineer? Or neither?
 * neither


 * What do you care about most when contributing to Wikimedia projects?
 * That's a really hard question to answer. I guess enabling others is what I'm aiming to do -- through knowledge or a functional UI.


 * What is your typical area of contribution in Wikimedia projects?
 * I work a lot in the Research namespace on Meta, but I build software products too.


 * What do you use when improving Wikimedia projects’ pages with better UI components (buttons, menus, etc)
 * Well... I don't usually try to improve a Project Page with a better UI, but when I do, I use templates and lua modules.


 * Or if you make gadgets / tools that relate to Wikimedia projects, what do you use for UI components?
 * My old stuff was ad-hoc. My more recent stuff uses OOJS ui.

Here are some example questions to get started with:
 * How do you go about looking for a UI component? For example, if you need a button, where do you look for it?
 * If I already know that I need a button, I just go to the developer reference. https://doc.wikimedia.org/oojs-ui/master/  When I wasn't sure what types of controls were available, I tried working with the living style guide, but it was incomplete.  So I used a mix of that and the developer reference.


 * Have you heard of OOJS UI? What do you think this it's used for?
 * I've been using it. E.g. m:Wiki labels

If you are more of a technical contributor: 
 * What’s a framework you most use (even outside of Wikimedia)?
 * Generally? Man.  I dunno.  I write a lot of python, so Flask is a common framework that I use.  Otherwise, I work a lot in a framework of my own design called [//github.com/wiki-ai/revscoring revscoring].  I still see OOJS UI as a library -- not a framework -- so I think I might not know what you mean to ask here.


 * Do you read documentation? When do you read documentation?
 * When I'm trying to work out if a library will do what I need it to. I'd also reference it while coding the thing I need.


 * What’s an example of a good framework documentation? What did you appreciate about it and what would you want to know more or less of?
 * [//scikit-learn.org/stable/ scikit-learn] has some really good docs.   It's like a developer reference merged with a cookbook.  I want just enough cookbook and explanation merged with the developer reference so that I can learn common usage patterns and also dig into the details without switching modes. [//flask.pocoo.org/ Flask] is an easy example of great docs too.


 * What’s an example of a poor documentation, what did you not appreciate about it and what would you want to know more or less of?
 * No documentation at all is the worst, of course. [//github.com/PyMySQL/PyMySQL pymysql] devs seem to expect you to read a reference and make some assumptions about what they implemented.  That was pretty lame.   Old versions of the living style guide contained code that was *planned* but not in place yet.  I spent tens of hours trying to figure out why I thought the library did something that it does not do.