Versions Compared

Key

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

Our first meeting will be held on Friday, December 10, 2010, from 3:00 to 4:00 p.m., EST (12:00 noon to 1:00 p.m., PST)
Call-in info:
Telephone: +1 812 856 7060
Conference Code: 22386#
PIN: 72524#

All agendas and minutes will be listed here as child pages in the future.

This effort was organized on the Help Files and Documentation Process Redesign page.

Tentative Agenda

1. Introductions/Expectations/Skills/Availability of participants

2. Current Status

  • Study of Samigo, at Stanford:  Current Status of Tests & Quizzes Documentation (R. Hill) 
  • Why is it so hard to document the portfolio tools?  (R. Hill, relying on S. Keesler)
  1. Because we're too lazy to learn the skills clearly designated as necessary; we want documentation to reveal the effort-free path.
  2. Because the Help files are written to an audience, trained faculty, that enjoys an environment of expert support.
  3. Because Sean's comprehensive documents on Confluence are found in different branches of the hierarchy.
  4. Because some Confluence pages have lost their context and suffer from neglect: http://confluence.sakaiproject.org/display/OSPDOC/Data+warehouse
  5. Because there is no visible intermediate result that affords the author a self-check of progress.
  6. Because there are assumed procedures and scenarios that hide restrictions.
  7. Because portfolios, insofar as they capture the essence of learning, are inherently complex objects.

3. Define goals

  • Scope (redistributable KB or wiki, prioritized list of docs needed)
  • Exploration of different levels of documentation for different audiences
  • SDK documentation for developers
  • Official policy for developers' institutions' submittal of documentation

4. Timeframe

5. Success stories, other products available?

...

Meeting Agendas and Minutes