Sakai 2.4 Consistency Check

To Do Items

Volunteers are needed to help with the following tasks:

  • Complete the table for the rest of the Sakai tools
  • Discuss and decide on what the consistent standard for each are should be
  • Document what needs to be changed to what where

Gonzalo will implement (working with other Project Teams to implement where necessary)

Sakai Formish Control Consistency Check

Below is a non-comprehensive list of the controls one uses to perform a formish action (add, preview, delete, view, edit, options) in Sakai to get some notion of the consistency issues involved. The problems toward consistency can be summed up as follows:

  1. Just lack of consistency - see Chat/options vs. Rec. Annc/options
    • need to decide on wording and apply
  2. Actions may not be similar enough to merit the same label - they only have a family resemblance - see the Assignment/add vs Discussion/topic/add
    • need to determine if the same wording will do for both, and if not, enforce some other order of consistency (position in sequence, for example)
  3. The inconsistency resides in the nature of the controls - see Announcements/view vs Schedule/view, one set is inputs at the bottom, the other links in the toolbar
    • need to change the lesser case (items in toolbar) to comform
  4. The inconsistency is due to context specific modifiers - see Discussion/deleteconf items. Is Save just as good as Save Event in the case of a Schedule/edit? Does it mean the same thing as Announcement/edit?. How about Resources/edit?
    • this may not have a solution - modifiers may always be too valuable - can we emphasize the verb instead?
  5. The inconsistency is due to unexpected behavior when pressing the enter key - Most web users expect that pressing the return key when the focus is on a text input field to submit the form (think about logging in). All forms should submit the data.
    • The only case I can think of where you wouldn't want that behavior would be on a confirmation screen where you were confirming that you were going to delete data. The "absent minded enter" in this case should NOT confirm the delete and instead cancel the action.
    • SAK-8452

Note: means that the control has "active" class. Numbers indicate sequential wizard control groups. Unless otherwise indicated the controls indicated are input controls.

  add preview deleteconf view edit options return / enter key target
Annoucements Add Announcement, Preview, Save Draft, Cancel Add Announcement, Edit, Save Draft, Cancel Remove, Cancel Edit, Delete [as links in toolbar] Save Changes, Preview, Save Draft, Cancel Update, Cancel Currently deletes form data
Assignment/assignment Post, Preview, Save Draft, Cancel Post, Save Draft, Edit, Done Delete, Cancel Back to list     Currently deletes form data
Assignment/grade Save, Return to Student, Preview, Cancel Save, Return to Student, Edit no delete possible no view possible Save, Return to Student, Preview, Cancel    
Assignment/take Submit, Preview, Save Draft, Cancel Submit, Save Draft, Edit no delete possible Back to list Submit, Preview, Save Draft, Cancel    
Chat Add Message, Clear         Update Options, Cancel  
Discussion/categ Create Category, Cancel   Delete Category, Cancel        
Discussion/topic Add Topic, Save Draft, Cancel   Delete Topic, Cancel Reply to Topic Add Topic, Save Draft, Cancel    
Discussion/reply Add Reply, Preview, Save Draft, Cancel Add Reply, Revise, Save Draft, Cancel Delete Message, Cancel Reply to Message, Reply to Topic Add Reply, Save Draft, Cancel    
Email arch     Remove, Cancel     Update Options, Cancel  
Home/wsite info           Update Options, Cancel  
Rec. Annc           Update, Cancel  
Rec. Chat           Update, Cancel  
Rec. Disc,           Update, Cancel  
Resources Add, Cancel   Remove, Cancel   Update, Cancel   Currently takes user to the Resources helper to add an attachment
Resources/reorder Save, Cancel            
Schedule Save Event, Cancel   Delete, Cancel Edit, Delete Save Event, Cancel    
site info         1) Continue, Cancel; 2)Finish, Back, Cancel    
site tools         1) Continue, Cancel; 2)Finish, Back, Cancel    
site tools/webcont         1)Continue,Back, Cancel;2) Finish,Back, Cancel    
site tools/news         1)Continue,Back, Cancel;2) Finish,Back, Cancel    
site tools/mailarch         1)Continue,Back, Cancel    
site groups Update, Cancel       Update, Cancel    
site access         Update, Cancel    
site participants 1)Continue, Back, Cancel; repeat x2;4)Finish, Back, Cancel            
site duplicate Duplicate, Cancel            
site import from site 1) Continue, Cancel; 2) Finish, Back, Cancel            
site import from file Import, Cancel            
syllabus Post, Preview, Save Draft, Cancel Revise Delete, Cancel   Post, Preview, Save Draft, Cancel   Currently takes user to the Resources helper to add an attachment
worksite setup 1) Continue, Cancel;2) Continue, Back, Cancel (repeat3x);6)Create Site, Back, Cancel   Remove, Cancel same categories as site info      

Notes

Collecting here 2 classes of things: gross inconsistency in operation on items, classes of actions that are special to a particular tool or tool/view

Announcements

deleteconf activated from list (controls: Update, Cancel) - why is Cancel needed? Not used in Assignments...What are we updating if there are no checkboxes selected?

view item:[as menubar links] Edit, Delete. Should be: input controls

special actions:

  1. merge: Save, Cancel

Assignments

deleteconf from list (controls: Update)

missing a delete grade action

missing a delete submission action

Discussion

deleteconf from list

no topic preview?

Email archive

deleteconf from item (as toolbar link) Should be: input controls

Schedule

deleteconf from item (with mailarch only tool where this is so - there is a good reason, though, as a calendar is not a list)

special actions:

  1. merge: Save, Cancel
  2. import: 1) Continue, Cancel;2)Continue, Back, Cancel;3) Import Events, Back, Cancel
  3. fields: Save Field Changes, Cancel

site groups

deleteconf from list (controls: Remove Checked, Back) - and "Remove checked" is disabled till something is picked

Syllabus

deleteconf from list (controls: Update)

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.