Wiki source code of Easy XWiki Summary (1.x)
Last modified by Vincent Massol on 2024/11/19 16:12
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | In July of 2009, many members from the XWiki Open-Source community met to talk about the product. One of the sessions they ran was "Easy XWiki", a session deicated to find out what could be improved to make the first 30 minutes of XWiki use more pleasant. Here is the summary of their findings. | ||
| 2 | |||
| 3 | = Easy XWiki = | ||
| 4 | |||
| 5 | {{toc/}} | ||
| 6 | |||
| 7 | Here is a summary of what people said about making XWiki Enterprise easier to use. | ||
| 8 | |||
| 9 | {{warning}} | ||
| 10 | Work in Progress | ||
| 11 | {{/warning}} | ||
| 12 | |||
| 13 | == User Interface == | ||
| 14 | |||
| 15 | === Dashboard === | ||
| 16 | |||
| 17 | ==== Spaces ==== | ||
| 18 | |||
| 19 | * Give more information about each space | ||
| 20 | * Use the title of the space's homepage as a title for the whole space | ||
| 21 | * Create space descriptors? | ||
| 22 | |||
| 23 | ==== Recent Changes ==== | ||
| 24 | |||
| 25 | * There should be no changes displayed when starting a new wiki | ||
| 26 | * Since a new wiki has had no activity going on, why are some modifications displayed? | ||
| 27 | * System page modifications should be hidden for normal users | ||
| 28 | |||
| 29 | ==== Tag Cloud ==== | ||
| 30 | |||
| 31 | * The tag cloud is hidden at the bottom of the list of spaces and hard to see | ||
| 32 | |||
| 33 | === Page Actions === | ||
| 34 | |||
| 35 | We should have only information available from the view mode, not stuff scattered all around the place, the user should be able to see 3 main things: | ||
| 36 | |||
| 37 | * where am I? | ||
| 38 | * what am I doing? | ||
| 39 | * what can I do? | ||
| 40 | |||
| 41 | Things should be easily answered by looking at the page. Right now we do not have a functional model that encompasses all this. | ||
| 42 | |||
| 43 | ==== Action bar ==== | ||
| 44 | |||
| 45 | * move the action bar (edit, show, watch...) closer to page content | ||
| 46 | * shortcuts should be described in the action menu | ||
| 47 | * use icons in the action bar to make it easier to understand | ||
| 48 | * splitting the action bar between local and global actions and create 2 menus | ||
| 49 | ** global one -> administration, create new content, manage watchlist | ||
| 50 | ** page menu -> actions related to the current page | ||
| 51 | |||
| 52 | ==== Logged-in / Logged-out ==== | ||
| 53 | |||
| 54 | * When not logged-in -> edit action is hidden | ||
| 55 | ** display the edit action as disabled to let people know it's a wiki | ||
| 56 | ** on a public website you don't want to see the action bar for guests anyway | ||
| 57 | |||
| 58 | ==== Page creation ==== | ||
| 59 | |||
| 60 | * streamline the link creation process -> make it faster, more simple | ||
| 61 | ** make document information more visible | ||
| 62 | * page creation panel on the right side that isn't good | ||
| 63 | ** when in the blog interface, it duplicates the creation panel (context issue) | ||
| 64 | ** should be a button | ||
| 65 | ** where is the page created? which other pages is the created page related to? | ||
| 66 | ** all create actions made contextual to the wiki (from treeview, from wikilinks) | ||
| 67 | * add tags, categories when creating a page | ||
| 68 | |||
| 69 | === Titles === | ||
| 70 | |||
| 71 | * page title issue -> name vs title, it's confusing | ||
| 72 | * use document titles instead of page names as much as possible | ||
| 73 | ** uniform name management when creating new pages | ||
| 74 | |||
| 75 | === Avatars === | ||
| 76 | |||
| 77 | * comments lack the user avatar | ||
| 78 | * make user avatars easy to use (macro) | ||
| 79 | |||
| 80 | === Other === | ||
| 81 | |||
| 82 | * too much information in search results, in the dashboard -> when you open it for the first time there's a lot of information but the user doesn't know where it comes from | ||
| 83 | * create panel should be improved -> create space is in the wrong place | ||
| 84 | * treeview navigation is confusing, it's hard to understand its logic right now | ||
| 85 | * information about comments, attachments, history to put at the top of the page? -> nobody sees them | ||
| 86 | |||
| 87 | === Consistency === | ||
| 88 | |||
| 89 | * same skin for the administration as for everything else | ||
| 90 | * unify the looks of the edit and view mode | ||
| 91 | ** in-place editing | ||
| 92 | ** same place, same configuration, nothing different but the edit | ||
| 93 | |||
| 94 | == Configuration & Administration == | ||
| 95 | |||
| 96 | === Configuration === | ||
| 97 | |||
| 98 | * first interaction -> first thing the user sees when the homepage is displayed -> display additional information for the first time -> steps you have to do to configure your wiki. Basic steps required to make your wiki work. Popup? | ||
| 99 | * hidden pages / spaces -> all pages in the space are hidden = hidden space? | ||
| 100 | |||
| 101 | === Administration === | ||
| 102 | |||
| 103 | * New spaces appear once I've logged in as an Admin. Why? | ||
| 104 | * Create accounts for new users -> I don't really know where to go. | ||
| 105 | * What is the order of icons in the administration? Why is it like that? | ||
| 106 | ** Explanatations for each item in administration (captions, tooltips) | ||
| 107 | ** Why OpenOffice? What is it doing here? It's an option. | ||
| 108 | ** Registration is confusing | ||
| 109 | * Administration: drop-down & "Show available categories" button put together. Why is that so? | ||
| 110 | ** The drop-down menu isn't self-explanatory, it doesn't tell anything about itself | ||
| 111 | ** "Add new user" should be at the top of the page | ||
| 112 | ** Clicking on "Create new user" launches a popup -> various interaction styles | ||
| 113 | *** what's mandatory, what's optional? | ||
| 114 | *** no error messages, information gets lost | ||
| 115 | *** email field not used by default | ||
| 116 | *** automatically generate a password for the user (-> invitation manager) | ||
| 117 | *** configuring registration options / process in XWiki in complicated | ||
| 118 | *** **email addresses are hidden in the user profile** | ||
| 119 | *** user profile -> actions are not in the right place | ||
| 120 | ** put user into a group | ||
| 121 | *** group names suck, system groups are not identified as such | ||
| 122 | *** edit button -> what am I editing, group name of group members? Right now renaming a group will break configured rights | ||
| 123 | *** on a group page -> "add user to group" button | ||
| 124 | *** local & global users -> what does that mean on a standard XE instance? | ||
| 125 | ** configuring rights | ||
| 126 | *** rights inheritance | ||
| 127 | *** it's dangerous to change XWikiAllGroup and XWikiAdminGroup rights yet it can be done easily | ||
| 128 | *** the deny warning is painful | ||
| 129 | *** select the rights you want and then apply them -> make the rights transactional (button to save) | ||
| 130 | *** revert rights to the default setting button | ||
| 131 | *** describe every right and explain how to set them | ||
| 132 | * sometimes configuration cannot be achieved but through objects -> an interface should always be available to make this explicit | ||
| 133 | ** hide technical pages even from admin, the admin shouldn't see everything -> like in windows, let people see / hide hidden documents | ||
| 134 | |||
| 135 | == Help == | ||
| 136 | |||
| 137 | * Add an "Help" panel between Search and Quick Links | ||
| 138 | * Make the link to the user guide more obvious | ||
| 139 | * Contextual help | ||
| 140 | * Make the help more obvious | ||
| 141 | ** when there's only one user in the wiki, display all the help, message disappears once another user has been created | ||
| 142 | * make the user guide easier to find, it cannot be found easily right now | ||
| 143 | |||
| 144 | == Language == | ||
| 145 | |||
| 146 | * Create language-specific distribution | ||
| 147 | ** Select the language from the installer | ||
| 148 | ** Choose the language of your wiki from the installer | ||
| 149 | * translations are painful and confusing to setup -> hard to find, hard to set, translations don't appear in all pages at once, when on a given page it's hard to know in which languages it has been translated. | ||
| 150 | ** lack of feedback when setting up translations |