Macro Usability Improvements
- XWiki
- Design
- Idea
- Add pickers on all macro configuration fields with predefined values: https://jira.xwiki.org/browse/XWIKI-23757
Macro name next to move handle: https://jira.xwiki.org/browse/XWIKI-22383
Macro content vs boundary: https://jira.xwiki.org/browse/XWIKI-22384
Discussion focused on macro configuration: https://forum.xwiki.org/t/macro-configuration-standards-ui-ux/14965/10
Discussion focused on macro look and behaviour in edit mode: https://forum.xwiki.org/t/macros-for-newbies-blank-states-scary-set-up/14329/25
Added by Mathieu on the XWiki Standard 18.x Cycle + Apps/XNNG/Cloud Brainstorming (XWikiSAS meeting), line 21 (ATM)
- No
Description
Last updates and agreed upon conclusions
Macro Configuration
#1 A field that has a limited list of possible values, should offer the user those values before selection (through any available UI) - made JIRA issue
#2 We should start linking documentation in macros even if that documentation is in english, even if it’s not always available. It is a step forward and will be of a lot of help to users. We don’t need to make everything perfect from the first time.
#3 Slightly more spacing between each property would be nice.
Macro block appearance and behaviour
#4 On hover, next to the move icon, we’d display an edit icon button and the name of the macro. JIRA Issue
#5 For the issue of differentiating macro boundary and content boundary: I think it highly depends on color contrast or just general accessibility:
- choose a different colour for content boundary (maybe main color or link color, if it has enough contrast in all cases)
or
- use a dashed line for macro boundary
#6 Empty macros render the “macro: content“ message. It’s good, but we could make it much nicer easily.
- add more padding (especially vertical)
- some round corners (by radius variable)
- add a light gray background (by color variable)
- instead of “macro: content“ just write “Empty macro. Use the edit icon or double click to configure it.“
Adina Milica