User:Aeric/Writing and Publishing Guide

Important: This page has been updated as of Jan, 2014. Other guide pages may be out of date.

Release Model

• Dated Cloud Releases

• The platform running in the cloud is updated at 2, 3, or 4 week intervals.
• When an update occurs, the features previously regarded as "Coming Soon" are added to the Release Notes, with a date to indicate when the update occurred.

• Versioned ISV Releases

• When a new "installable version" is released, a snapshot of the cloud wiki is taken.
• The snamsphot is given a version number.
• The help link in the installable version points to that wiki so that, as features evolve in the cloud, accurate help remains available for the installable version.

• Wikis

• lj_wiki -- LongJump wiki in the cloud
• lj{v#} (ex: lj100) -- Versioned LJ ISV wiki
• aa_dev (to be renamed. currently mw_dev) -- pre-release AA wiki
• aa_wiki (to be renamed. currently mw_prod) -- AA wiki in the cloud
• aa(v#} (ex: aa100) -- Versioned AA ISV wiki

Note: A two-digit version number would probably be sufficient. The extra digit is included in case a intermediate versioned release is needed--for example: 10.1. But that circumstance may never occur. So lj10 and aa10 would be simpler--and lj101 could always be created, if needed.)

• Help Links

• The help link in the cloud points to the appropriate wiki:

• AgileApps ==> agileappslive.info/wiki, which references the aa_wiki.
• LongJump ==> lj.platformatyourservice.com/wiki, which references lj_wiki.

• Help links in the installable versions point to a versioned wiki:

• AgileApps ==> agileappslive.info/aa10 (for example)
• LongJump ==> isv.platformatyourservice.com/lj10 (for example)

(Note that the "isv" subdomain is used for the versioned wiki, to activate the "whitelabel" skin.

Procedures

The procedure to use depends on the type of activity and the target of that activity.

Activity	AgileApps	LongJump
Critical Bug Fix Feature not usable.	Fix AA dev wiki Fix AA prod wiki Fix current ISV wiki	Fix LJ wiki current LJ ISV wiki
Minor Fix or Cosmetic Improvement	Modify the AA Dev wiki page. (Changes will migrate at next dated release.)	When an equivalent AA page is reorganized: Reflect the reorg in the LJ wiki to ensure that future changes can be made without difficulty. Skip all other "cosmetic" improvements.
New Feature		Add docs to the LJ wiki Add a "Coming soon" entry w/link to docs (There is no "pre-release" wiki.)
Dated Cloud Release	First one: Convert Release Notes page from redirect to dated listing Move features from Coming Soon page to Release Notes page Activate "check back" text on Coming Soon page, unless future features remain)
Versioned ISV Release	Move "Release Notes" page to "Version ## Platform" Activate the redirect on the release notes page	Move "Release Notes" page to "Version ## Platform" Activate the redirect on the release notes page

New Features

1. Document new features 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 transclusions of Template:TBD
• In the dev wiki, change the Coming Soon heading to reflect the release date.
  http://agileappslive.com/mw_dev/Platform_Features
• Leave unimplemented entries under Coming Soon or, if there are none, comment out that section

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