Tests and Quizzes Documentation Group

Review Team Members (alphabetical):

• Robin Hill, University of Wyoming
• Alan Regan, Pepperdine University

NOTE: Stanford's review contact is Jackie Mai, jamai@stanford.edu
SAMigo_2.8_Help_Docs_Final.doc

Identified Concerns:

• Audience: I applaud the writers for adding a much needed improvement to the overview page. They have added categories that help provide more context to the links. Great work!  I would like to build even further on this enhancement.
  • For a moment, put yourself in the shoes of a student. How easy is it to find pages that are specific to student users?  I think we can improve the home page even further by clarifying which pages are for test takers (students) and test creators or makers (instructors).
  • On all subsequent pages, it may be beneficial to list the primary audience for the page on the page itself. This way, a student or instructor doesn't have to skim content to see if the page is meant for them or not. If we can identify the audience at the top of each page, this may be a benefit to our users.
• Order: The order of the pages in the left navigation and on the overview page is unclear. Why are the pages listed in this specific order?
• Links or Headings: I discovered that the page headings sometimes do not match the page titles in the left navigation (e.g. "Create survey" link in help menu vs. "Creating a survey" as heading of the page). I am not sure if this is intended (for expanding keyword searches) or accidental. I'd like to learn more about the reasoning for the two sets of wording.
• Anchors: Not all pages have "top" anchor names.
• Breadcrumb: Would it be helpful to provide a "back" link to the home page of the tool at the top and bottom of every page?
• Localization: Doesn't seem that all of the pages have equivalent pages in some foreign languages. Missing languages noted in "Source for Help Files" section below.

Proposed Page Changes

(Listed in the same order as the left navigation of the Help tool. This is not necessarily the order we recommend for the final pages.)

• 01 - arfu - Tests & Quizzes
• 02 - arfk - Tests & Quizzes Overview
• 03 - ardm - Create new assessment
• 04 - aqyr - Create Questions
• 05 - azms - Formatting Questions for Quick Create
• 06 - arde - Preview Assessment
• 07 - arcs - Restrict Access to Published Assessments
• 08 - arec - Order Questions
• 09 - arag - Available Settings
• 10 - argy - Available Question Types
• 11 - arbr - Formatting Toolbar
• 12 - ardr - Add Create Edit Delete Template
• 13 - arek - Give an Assessment
• 14 - ardc - Publish an Assessment
• 15 - arab - Modify Assessment
• 16 - arbq - Modify Published Assessment
• 17 - arba - Retract Published Assessment
• 18 - arcx - Delete Assessment
• 19 - aqys - Export Assessment
• 20 - arbx - Question Pools
• 21 - arej - Add Move Copy Remove Question Pools
• 22 - ardf - Add Questions to Question Pool
• 23 - arev - Control Access to Question Pool
• 24 - areg - Move Questions
• 25 - arbz - Edit Metadata
• 26 - arcq - Create Survey
• 27 - arbn - Take Assessment
• 28 - ardi - Resume Taking Assessment
• 29 - aszx - View Student Scores And Answers
• 30 - arro - Send Assessment Scores to Gradebook

Gallery

Source for Help Files:

• https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/
• Listed in order of the help page viewer:
• Tests/Quizzes (Page heading, "Tests & Quizzes" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arfu.html ) -- NOTE I don't see other language versions for this file, no ru or zh versions.
  • Tests/Quizzes Overview (Page heading, "Tests & Quizzes: Overview" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arfk.html )
  • Create New Assessment (Page heading, "Creating a new assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/ardm.html )
  • Create Questions (Page heading, "Creating questions for an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/aqyr.html )
  • Formatting Questions for Quick Create (Page heading, "Formatting questions with markup text" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/azrq.html ) -- NOTE I don't see other language versions for this file, no ru or zh versions.
  • Preview Assessment (Page heading, "Previewing an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arde.html )
  • Restrict Access to Published Assessments (Page heading, "Restricting access to published (sic - line break in xml) assessments" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arcs.html )
  • Order Questions (Page heading, "Ordering questions" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arec.html )
  • Available Settings (Page heading, "Assessment settings" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arag.html )
  • Available Question Types (Page heading, "Types of questions available for (sic - line break in xml) assessments" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/argy.html )
  • Formatting Toolbar (Page heading, "Using the WYSIWYG editor" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arbr.html )
  • Add/Create/Edit/Delete Template (Page heading, "Adding, editing, or deleting an (sic - line break in xml) Assessment Type" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/ardr.html )
  • Give an Assessment (Page heading, "Giving an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arek.html )
  • Publish an Assessment (Page Heading, "Publishing an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/ardc.html )
  • Modify Assessment (Page heading, "Modifying an existing assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arab.html )
  • Modify Published Assessment (Page heading, "Modifications to (sic - line break in xml) published assessments" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arbq.html )
  • Retract Published Assessment (Page heading, "Retracting or removing an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arba.html )
  • Delete Assessment (Page heading, "Deleting an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arcx.html )
  • Export Assessment (Page heading, "Importing or exporting assessments" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/aqys.html )
  • Question Pools (Page heading, "Question pools" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arbx.html )
  • Add/Move/Copy/Remove Question Pools ( "Adding, moving, copying, or removing a (sic - line break in xml) question pool or subpool" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arej.html )
  • Add Questions to Question Pool (Page heading, "Adding questions to a question pool or (sic - line break in xml) subpool" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/ardf.html )
  • Control Access to Question Pool (Page heading, "Sharing question pools" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arev.html )
  • Move Questions (Page heading, "Moving questions between parts of an (sic - line break in xml) assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/areg.html )
  • Edit Metadata (Page heading, "Editing metadata in assessments" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arbz.html )
  • Create Survey (Page heading, "Creating a survey" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arcq.html )
  • Take Assessment (Page heading, "Taking an assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arbn.html )
  • Resume Taking Assessment (Page heading, "Resume taking a saved assessment" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/ardi.html )
  • View Student Scores And Answers (Page heading, "Viewing participant scores and answers to individual questions" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/aszx.html ) -- NOTE Something different in this file.  All other files display as plain text in Firefox.  This one displays as formatted HTML.  Only page with this behavior for this tool.
  • Send Assessment Scores to Gradebook (Page heading, "Why doesn't the assessment I created appear (sic - line break in xml) in my gradebook?" - https://source.sakaiproject.org/svn/sam/branches/samigo-2.8.x/samigo-help/src/sakai_samigo/arro.html ) -- NOTE I don't see other language versions for this file, no ru or zh versions.