svn commit: r1412357 - in /ace/site/trunk: content/user-doc/ace_user_management_admin_ui.png content/user-doc/ace_user_management_newuser_ui.png content/user-doc/ace_user_management_user_ui.png content/user-doc/useradmin-ui.mdtext templates/sidenav.html

[ma...@apache.org]

Author: marrs
Date: Wed Nov 21 23:18:39 2012
New Revision: 1412357

URL: http://svn.apache.org/viewvc?rev=1412357&view=rev
Log:
ACE-304 Added user documentation for user management.

Added:
    ace/site/trunk/content/user-doc/ace_user_management_admin_ui.png   (with props)
    ace/site/trunk/content/user-doc/ace_user_management_newuser_ui.png   (with props)
    ace/site/trunk/content/user-doc/ace_user_management_user_ui.png   (with props)
    ace/site/trunk/content/user-doc/useradmin-ui.mdtext
Modified:
    ace/site/trunk/templates/sidenav.html

Added: ace/site/trunk/content/user-doc/ace_user_management_admin_ui.png
URL: http://svn.apache.org/viewvc/ace/site/trunk/content/user-doc/ace_user_management_admin_ui.png?rev=1412357&view=auto
==============================================================================
Binary file - no diff available.

Propchange: ace/site/trunk/content/user-doc/ace_user_management_admin_ui.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: ace/site/trunk/content/user-doc/ace_user_management_newuser_ui.png
URL: http://svn.apache.org/viewvc/ace/site/trunk/content/user-doc/ace_user_management_newuser_ui.png?rev=1412357&view=auto
==============================================================================
Binary file - no diff available.

Propchange: ace/site/trunk/content/user-doc/ace_user_management_newuser_ui.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: ace/site/trunk/content/user-doc/ace_user_management_user_ui.png
URL: http://svn.apache.org/viewvc/ace/site/trunk/content/user-doc/ace_user_management_user_ui.png?rev=1412357&view=auto
==============================================================================
Binary file - no diff available.

Propchange: ace/site/trunk/content/user-doc/ace_user_management_user_ui.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: ace/site/trunk/content/user-doc/useradmin-ui.mdtext
URL: http://svn.apache.org/viewvc/ace/site/trunk/content/user-doc/useradmin-ui.mdtext?rev=1412357&view=auto
==============================================================================
--- ace/site/trunk/content/user-doc/useradmin-ui.mdtext (added)
+++ ace/site/trunk/content/user-doc/useradmin-ui.mdtext Wed Nov 21 23:18:39 2012
@@ -0,0 +1,79 @@
+Title: User Management Guide
+
+This article describes how to use ACE's user management. This article is meant for users who have at least a basic understanding of how ACE works and have it up and running. It describes which type of users are provided, and how to add, remove, view and edit users using the UI facility supplied with ACE.
+
+## Introduction
+
+ACE provides a standard set of users and roles in which they reside. This determines not only user permissions regarding releases, but also regarding user management. Using the built in user management system, users can be assigned to administrator or non-administrator roles. Currently the provided set of users only contains one administrator role, literally called 'Administrator'. When logged in as a user with this permission, one can perform CRUD (Create, Read, Update, Delete) operations on an ACE userbase. All other roles provide standard user functionality, which only allows a user to change his or her own password. Both roles also have a different management window as explained below.
+
+## Administrator view
+
+ACE supplies a default set of users, as seen [here](https://cwiki.apache.org/confluence/display/ACE/Permissions+and+roles#).
+Currently, the only administrator is the user 'd', with a password 'f'.
+
+When logged in as an administrator, a 'Manage Users' button appears in the top menu bar. When clicking this button, the following window appears:
+
+<a href="ace_user_management_admin_ui.png" target="_blank"><img src="ace_user_management_admin_ui.png" width="640px" title="Figure 1: The user management UI of ACE, seen from an administrator account." /></a>  
+**Figure 1**: The user management UI of ACE, seen from an administrator account. (click on image to see full size).
+
+The window is essentially divided into two columns, a table on the left side showing all registered users, and the selected user's specific data on the right side. Below the table, two buttons are displayed, a '+' and a '-' button. These buttons allow an administrator to add or remove users.
+
+The available user management actions are:
+
+1. Viewing all users
+2. Adding a new User
+3. Deleting an existing user
+4. Changing existing user data (Username, Password & Role)
+5. Changing your own password
+
+The below section describes how to perform these actions.
+
+**NOTE**: Allowing only a password change for an administrator is done on purpose. It should be noted that changing an active user's username should not be done, and a role change is very unsafe because a situation could occur where no administrators are left to manage the userbase.
+
+### Viewing all users
+This is rather self explanatory, but to view all users and their data, just click on any user in the table.
+
+### Adding a new user
+To add a new user, click the '+' button, the form then changes to input fields where the new user's details can be supplied as seen below.
+
+<a href="ace_user_management_newuser_ui.png" target="_blank"><img src="ace_user_management_newuser_ui.png" width="640px" title="Figure 2: The user management UI when adding a new user." /></a>  
+**Figure 2**: The user management UI when adding a new user. (click on image to see full size).
+
+The form supplies two fields, for a username and password, and a select box to choose a role.
+After completing the form and selecting a role, clicking the 'Add' button adds the new user to ACE. Clicking the cancel button discards all input and cancels the addition of a new user.
+
+**NOTE**: Both fields and the selection of a role are mandatory!
+
+### Deleting an existing user
+Select the user to be deleted, and click the '-' button, located under the table.
+
+**NOTE**: An administrator cannot remove his or her own account!
+
+### Changing existing user data
+Click any user in the table who's data should be added. The form on the right then changes to input fields, allowing changes to be made. Click 'Apply' to save the changes made. When the changes should not be applied, just select another user, and the input is discarded.
+
+**NOTE**: Changes are only saved per user, and only when clicking the 'Apply' button. Batch editing is not possible!
+
+### Changing your own password
+As an administrator you can only change your own password. This is done by selecting your own username in the table, and then editing the password field on the right. Clicking 'Apply' saves your new password, selecting another user discards the change.
+
+
+## Default User View
+
+All other users supplied with ACE are default users. Regarding user management, they're only allowed to change their own password.
+When a logged in as a default user, a 'My Info' button appears in the top menu bar. When clicking this button, the following window appears:
+
+<a href="ace_user_management_user_ui.png" target="_blank"><img src="ace_user_management_user_ui.png" width="640px" title="Figure 3: The user management UI of ACE, seen from a default user's account." /></a>  
+**Figure 3**: The user management UI of ACE, seen from a default user's account. (click on image to see full size).
+
+### Changing a default user's password
+To change a default user's password, a user has to click the 'My Info' button. The desired password can then be inserted into the password field on the right. Clicking the 'Apply' button saves the change.
+
+
+
+
+
+
+
+
+

Modified: ace/site/trunk/templates/sidenav.html
URL: http://svn.apache.org/viewvc/ace/site/trunk/templates/sidenav.html?rev=1412357&r1=1412356&r2=1412357&view=diff
==============================================================================
--- ace/site/trunk/templates/sidenav.html (original)
+++ ace/site/trunk/templates/sidenav.html Wed Nov 21 23:18:39 2012
@@ -25,10 +25,12 @@
       <li>
         <a href="/user-doc/features.html">Features</a>
       </li>
-	  <li>
+	    <li>
         <a href="/user-doc/restapi.html">Client REST API</a>
       </li>
-
+      <li>
+        <a href="/user-doc/useradmin-ui.html">User Management Guide</a>
+      </li>
       <li>
         <a href="/user-doc/faq.html">FAQ</a>
       </li>