Wiki source code of XWiki's User Experience

Last modified by Simon Urli on 2023/10/10 12:09

Show last authors
1 {{toc start="2"/}}
2
3 == Design Process ==
4
5 The process involves the creation of specifications, analysis, mockups, partial prototypes and even final versions of the proposals made. The aim of these proposals are to improve XWiki's interface, look&feel, usability, experience and interaction.
6
7 * Design //planning// for improvements/features is made according to the current [[XWiki Roadmap>>xwiki:Roadmaps.WebHome]]
8
9 * Design //discussions// are made on the [[XWiki Chat>>Community.Chat]] or on the [[XWiki forum>>Community.Discuss]]
10 ** design discussions on the forum have ##proposal## and/or ##ux## as labels and are made in the ##Development## category.
11
12 * Design //proposals// deliverables (use cases/requirements/mockups/prototypes) are located on [[Design>>design:Main.WebHome]] wiki (example:[[ [Proposal] Flamingo Skin>>design:Improvements.Skin4x]])
13
14 == UX Topics ==
15
16 {{include document="design:Improvements.Keywords"/}}
17
18 === Topics Definition ===
19
20 * //User Experience// answers the question, “Did the user have as delightful an experience as possible?”
21 * //Usability// answers the question, “Can the user accomplish their goal?” with effectiveness and efficiency
22
23 //User Experience// encapsulates all the other subtopics, but being very broad is also very hard to define it and quantify it by appropriate marking the JIRA issues. That's why 'ux' label is //not recommended// and is more specifically defined by the 'usability' label.
24 //Usability// is a subset of the overall User Experience, while //Accessibility// and //Consistency// (//Standard// is related to Consistency) are subsets of Usability. When labelling an issue choose the most specific topic.
25
26 === Issues Labels ===
27
28 You can contribute and help us [[report>>Community.Contributing#HTesting]] issues within XWiki. There are several tags that can be added to a [[JIRA>>https://jira.xwiki.org/]] issue in order to mark it important from an user experience point of view: ##ux##, ##usability##, ##consistency##, ##standard##, ##wcag##.
29 Initially these issues were marked using the '##keywords##' field, but now this field is deprecated in favour of '##Labels##' field.
30
31 * **User experience** (UX) involves a person's behaviours, attitudes, and emotions about using a particular product, system or service.
32 ** Label: [['ux'>>https://jira.xwiki.org/issues/?jql=labels%20%3D%20ux]] (% class="noitems" %)(not recommended)(%%) - is the user not having a great/delightful experience using the product?
33 *** Keyword: [[ux>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&customfield_10000=ux]] (% class="noitems" %)(deprecated)
34 * **Usability** is the ease of use and learnability of a human-made object.
35 ** {{success}}Label: [[**'##usability##'**>>https://jira.xwiki.org/issues/?jql=labels%20%3D%20usability]] (% class="noitems" %)(recommended)(%%) - does the user have problems accomplishing his task?{{/success}}
36 *** Keyword: [[usability>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&customfield_10000=usability]] (% class="noitems" %)(deprecated)
37 * **Consistency** states that things that are related should be presented in a similar way.
38 ** {{warning}}Label: [['##consistency##'>>https://jira.xwiki.org/issues/?jql=labels%20%3D%20consistency]] - are elements that define/break the interface consistency?{{/warning}}
39 *** Keyword: [[consistency>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&customfield_10000=consistency]] (% class="noitems" %)(deprecated)
40 * **Standard** refers to defining elements that will be reuse throughout XWiki (like [[.xform>>xwiki:Documentation.DevGuide.FrontendResources.VerticalForms]]) and applying them to existing interface elements
41 ** Label: [['##standard##'>>https://jira.xwiki.org/issues/?jql=labels%20%3D%20standard]] - are elements that define/break the interface standard?
42 *** Keyword: [[standard>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&customfield_10000=standard]] (% class="noitems" %)(deprecated)
43 * **Accessibility** means that people with disabilities can perceive, understand, navigate, and interact with websites and tools, and that they can contribute equally without barriers
44 ** Label: [['##wcag##'>>https://jira.xwiki.org/issues/?jql=labels%20%3D%wcag%20]] (% class="noitems" %)(recommended)(%%) - are there accessibility problems users are facing while using the product?
45
46 ==== Defining an 'usability' issue ====
47
48 * Usability issues refer exclusively to interface/front-end issues, since only these issues affect the end-user directly.
49 * The generic definition of an usability issue is if it is preventing the user from completing a task. This means the functionality is not usable and thus useless.
50 * Improvements on a specific functionality are also considered usability issues if implementing that functionality will provide an obvious benefit to the user by making things clearer, easier to use, improving learnability, improving the way the user interacts with the system, boosting productivity etc.
51 ** Most of the 'Improvements' issues are usability improvements, but this doesn't mean 'Bugs' or 'New Features' cannot be labeled as usability issues. Also we could have 'Improvements' that are not usability issues.
52 * So, in general, usability issues are front-end improvements that provide functionality that enhance the user's interaction with the product.

Get Connected