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

Gallery

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.)

Identified Concerns:

• 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?
• 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.  However, this can still be improved.  Plus, if a user clicks a link, there isn't anything on the page that identifies of the audience or role for the page.
• 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).
• Anchors: Not all pages have "top" anchor names.
• 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.

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.