Deployment Guide/Creating a new release

From OLPC
Jump to: navigation, search


Pencil.png NOTE: The contents of this page are not set in stone, and are subject to change!

This page is a draft in active flux ...
Please leave suggestions on the talk page.

Pencil.png

The following process describes how to review and update the wiki version of the Deployment Guide to create a new release of the Google Doc version.

  1. Planning
    1. Identify OLPC sponsor for new Deployment Guide release
    2. Agree who in OLPC is nominated to review changes to the deployment guide
    3. Agree goals of new release and high level milestone plan
    4. Update the Improving the Deployment Toolkit page in the wiki with the goals, approach and plan
  2. Mobilisation
    1. Form core team
    2. Identify key stake holders and subject matter experts
    3. Agree roles and responsibilities including who should be responsible, accountable, consulted or informed about what at which stage in the project
    4. Preparation
      1. Check sections with the same title as new sections you want to add don't already exist and if they do make a decision about whether to edit that live page directly or to take a copy and publish it by copying it back later as we do with the main Deployment Guide page
      2. Review material in the ClassActs/Resources section
      3. Identify existing material that could be referred to by or moved into the new sections
    5. Add new sections (see all sections in the Draft Deployment Guide, new sections are marked with a *)
    6. Follow all links from the Draft Deployment Guide according to priorities
      1. Combine or delete pages where appropriate, updating any references to these at the same time
      2. Review and update pages to improve clarity, navigation and accuracy
      3. Split pages into multiple sections or pages where appropriate
      4. Add cross references between pages where appropriate
    7. Review structure and flow of the Draft Deployment Guide
    8. Add additional navigation / cross references between sections as required
    9. Add clearer reference to the official Deployment Guide, Deployment Toolkit and Contacts List
    10. Go through the google doc and add missing material back into the Working Deployment Wiki
    11. Use the discussion tab for each wiki page for sharing ideas and review comments
  3. Review Draft Deployment Guide with OLPC
  4. Create google doc from Draft Deployment Guide
  5. Review google doc with OLPC
  6. Agree publishing date and comms with OLPC
  7. Copy the Draft Deployment Guide back into the Deployment Guide
  8. Announce new Deployment Guide and google doc
  9. Use this section as a basis for creating the Process for Releasing New Deployment Guide
  10. Create a Deployment Toolkit (wiki page and excel spreadsheet)
    1. Obtain latest versions of spreadsheets
    2. Combine the OLPC Deployment Workbook Excel spreadsheet (country budget planner) with the Economic Template Excel spreadsheet
    3. Simplify
    4. Improve usability
    5. Update assumptions if required (contact authors)
    6. Align the Deployment Toolkit with the Deployment Guide
      1. For each line item in the spreadsheet there should be a corresponding section in the wiki
      2. For each relevant section in the wiki, the spreadsheet should allow budget planning for it, e.g.
        1. Power generation solutions
        2. Teacher training options
        3. Project support resourcing options