Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Study of Samigo, at Stanford-- Current Status of Tests & Quizzes
    A. Source Code
    Original code written by programmers long gone, so some inline comments are out-of-date, but remain because the new developers didn't bother to remove them and in case they provided some history behind the code. New inline comments are added by current developers.
    B. Functional Specs on Confluence
    Lydia Li and the other developers (Karen Tsao takes care of Samigo), maintain the "Project: Samigo" web pages, with systematic updates on every new release.  The Academic Computing group is not aware of any formal Sakai requirement.
    This compares favorably with most other Projects' pages.  Some Project pages on Confluence show no activity since 2.5, some still active, some dormant since 2006 or 2007.
    C. User Docs for Instructors and Students
    • Community: Help files for the Knowledge Base are reviewed by the Adademic Computing team, and updated if necessary by Jackie Mai, User Experience specialist.  Done for 2.7/2.8 in November.
    • Local (CourseWork): Extensive documentation site, with Help files following, but not identical to, the KB files; and other how-to documents, FAQ, and outstanding issues, and release notes for new CourseWork deployments (every quarter or so).
  • For developers and deployers:
    Many of the current resources labeled "Documentation":
    sakaiproject Sakaiproject.org/documentation
    Confluence "Project: Documentation"
  • For Portfolio, a case study:  Why is it so hard to document the portfolio tools?  (R. Hill, relying on S. Keesler)

...