User:Aeric/Writing and Publishing Guide

Documenting New Features

1. New features are fully documented in the Dev wiki
   http://agileappslive.info/mw_dev
2. Put a Coming Soon entry into the platform features page, with a Learn More link to that documentation:
   http://agileappslive.info/mw_dev/Platform Features
3. When that entry is good enough for use, copy it to the production wiki (minus the Learn More link:
   http://agileappslive.info/wiki/Platform Features

Publication Process

First, prepare the development wiki for publication. Then execute the publishing process.

Preparation:

• Find and fix all references to Template:TBD
• In the dev wiki, change the Coming Soon heading to reflect the release date.
  (Leave unimplemented entries under Coming Soon or, if there are none, comment it out:
  http://agileappslive.com/mw_dev/Platform_Features

Publication:

1. Using PuTTY, log in to the Rackspace server
2. Run scripts/publishDevWiki to copy the contents of the
   development wiki (mw_dev) to the production wiki mw_prod

   This process makes a backup of the production wiki.

   If there is ever any need to revert to a previous version,
   run scripts/restoreWikiInstructions for a list of steps