message: Adding description of a Bamboo plan.
diff: @@ -62,7 +62,7 @@ can do the following:
  contain the detailed output generated by Google Test and FRUIT.
  We also have one plan that builds and runs tests on the master branch on
  -a selct set of platforms and compilers once per week. Each member of the team
  +a select set of platforms and compilers once per week. Each member of the team
  receives an email indicating passes and failures of builds and tests.
  @@ -86,6 +86,33 @@ Basic Bamboo Test Plan Management
  .. important:: Section under construction....
  +Creating and Configuring a Bamboo Plan
  +----------------------------------------
  +
  +A Bamboo plan consists of stages, each of which represents a step in a
  +build and/or test process. Each stage may contain one or more jobs that can
  +be run in parallel by Bamboo. For example, you may have a stage that compiles
  +a code and multiple testing stages which follow that can run in parallel.
  +Each stage contains specific tasks to run. Currently, Axom plans don't exercise
  +parallel execution in Bamboo. A typical Axom test plan consists of a set of
  +stages, one to build the code and run tests for each platform and compiler
  +combination. The tasks comprising a stage are shell commands that navigate
  +workspace directories on LC systems, check out the axom code, and run scripts
  +(that we archive in our source code repo) that encode all of the code
  +compilation and test execution operations. A final stage parses CTest output.
  +
  +To see the specific contents of any particular plan, click on the Axom project
  +in one of our Bamboo projects and click on a plan. Then, in the 'Actions'
  +pull-down menu at the upper right, click on 'Configure plan'. Clicking on
  +the 'Stages' tab will reveal the stages in the plan and clicking on a stage
  +will show the tasks in the stage, including shell commands, scripts that
  +are run, etc.
  +
  +Before we describe how to create and configure a plan, it is important to
  +note that every Bamboo project has *agents* the run Bamboo jobs on LC
  +platforms. When Bamboo executes a plan, it communicates with an agent
  +associated with it that runs tasks on the machine.
  +
  .. important:: The content below is mainly usage notes. Much of what we want
  to include here will be pulled from `Our Confluence Notes on Bamboo <https://lc.llnl.gov/confluence/display/ASCT/Bamboo+How-To%27s>`_
  