ANGEL Doc Team Wiki

From ETS

Jump to:navigation, search

Team Members

Meeting Times

ANGEL 7.3 Documentation Process Lessons Learned

The Doc Team met on Friday, 6/3, to review the 7.3 documentation process to see what worked and what can be improved. A full recording of the meeting can be found at (https://breeze.psu.edu/p94799594/) .

Successes:

  1. ANGEL Learning's Documentation (Mary did a great job of parsing out the sections each individual was responsible for
  2. The preview server (including both vanilla and PSU customizations
  3. Talisma
  4. Hypersnap


Opportunities:

  1. How we mark our documents.
    1. The team would like to come up with a consistent process for marking changes to the documents. The consistency will make it easier for Mary to identify changes as well as make it easier for one team member to pick up where another has left off, if need be.
  2. How we track our documents
    1. The team would like to be more consistent with keeping the spreadsheet updated. Ideally we would like to do this in real time but if need be we can do it during the doc team meetings.
  3. How we provide document status (primarily to Mary but to the rest of the team as well)
    1. The Team would like to agree upon a standard format for updating Mary on document status. This includes email and within Talisma
  1. During the upgrade process team members would like to take turns previewing the tools and features they are responsible for. Because we're so focused on our own piece of the upgrade, we have difficulty keeping up with the big picture. This should help us reduce the learning curve.
    1. These recordings could be shared with the Penn State Community via the ANGEL Community Hub.
  1. Could help with article review, approval, and publication
  2. Could be Jeff or someone else
Navigation
Toolbox