<?xml version="1.0" encoding='UTF-8'?>

<!--
Copyright 2006 Niels Heirbaut. All rights reserved.

Redistribution and use in source (XML DocBook) and 'compiled' forms (SGML,
XML, HTML, PDF, PostScript, RTF and so forth) with or without modification, are
permitted provided that the following conditions are met:

   1.  Redistributions of source code (XML DocBook) must retain the above
       copyright notice, this list of conditions and the following disclaimer
       as the first lines of this file unmodified.

THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
-->

<!--
This template can be used to create a Measurement Plan as described in the
Rational Unified Process. Where applicable, comments will provide guidance to
the author. At the authors discretion these comments can be deleted.
-->

<!--{{{-->
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"
[

<!--
Text entities. They are used to define document wide definitions. Replace the
'@@@ xxx @@@' definitions with the correct ones. If necessary custom text
entities should be added here.
-->
<!--{{{-->
<!ENTITY projectname    "@@@ Your Project @@@">
<!ENTITY projectacronym "@@@ Your Project Acronym @@@">
<!ENTITY firstname      "@@@ First Name @@@">
<!ENTITY surname        "@@@ Last Name @@@">
<!ENTITY copyrightyear  "@@@ Year @@@">
<!--}}}-->

]>
<!--}}}-->

<book lang="en"><!-- Measurement Plan {{{-->

  <!--
  This is the front matter definition of the Measurement Plan. Most data is set
  through the text entities above. Only the history per revision has to be set
  by hand. See <revhistory> below.
  -->
  <bookinfo><!-- Front Matter {{{-->

    <title>&projectname;</title>
    <subtitle>Measurement Plan</subtitle>

    <author>
      <firstname>&firstname;</firstname>
      <surname>&surname;</surname>
    </author>

    <copyright>
      <year>&copyrightyear;</year>
      <holder>&firstname; &surname;</holder>
    </copyright>

    <revhistory>

      <!--
      For each revision a <revision> section has to be added.
      -->
      <revision>
        <revnumber></revnumber>
        <date></date>
        <authorinitials></authorinitials>
        <revremark></revremark>
      </revision>

    </revhistory>

  </bookinfo><!--}}}-->

  <!--
  The introduction of the Measurement Plan provides an overview of the entire
  document. It includes the purpose, scope, definitions, acronyms,
  abbreviations, references, and overview of this Measurement Plan.
  -->
  <chapter><!-- Introduction {{{-->
    <title>Introduction</title>

    <!--
    Specify the purpose of this Measurement Plan.
    -->
    <section><!-- Purpose {{{-->
      <title>Purpose</title>

      <para>
      </para>

    </section><!--}}}-->

    <!--
    A brief description of the scope of this Measurement Plan; what Project(s)
    it is associated with and anything else that is affected or influenced by
    this document.
    -->
    <section><!-- Scope {{{-->
      <title>Scope</title>

      <para>
      </para>

    </section><!--}}}-->

    <!--
    This section provides the definitions of all terms, acronyms, and
    abbreviations required to properly interpret the Measurement Plan. This
    information may be provided by reference to the project's Glossary.
    -->
    <section><!-- Definitions, acronyms and abbreviations {{{-->
      <title>Definitions, acronyms and abbreviations</title>

      <para>
      </para>

    </section><!--}}}-->

    <!--
    This section provides a complete list of all documents referenced elsewhere
    in the Measurement Plan. Identify each document by title, report number if
    applicable, date, and publishing organization. Specify the sources from
    which the references can be obtained. This information may be provided by
    reference to an appendix or to another document.
    -->
    <section><!-- References {{{-->
      <title>References</title>

      <para>
      </para>

    </section><!--}}}-->

    <!--
    This subsection describes what the rest of the Measurement Plan contains
    and explains how the document is organized.
    -->
    <section><!-- Overview {{{-->
      <title>Overview</title>

      <para>
      </para>

    </section><!--}}}-->

  </chapter><!--}}}-->

  <!--
  State the goals of the measurement program relative to the project in terms
  of achievement, improvement, and quality.
  -->
  <chapter><!-- Management Goals and Subgoals {{{-->
    <title>Management Goals and Subgoals</title>

    <para>
    </para>

  </chapter><!--}}}-->

  <!--
  Enumerate the metrics that are to be synthesized at regular intervals on the
  project to support the goals.
  -->
  <chapter><!-- Metrics {{{-->
    <title>Metrics</title>

    <para>
    </para>

    <!--
    Create a new section for each metric and use the table included in the
    section to describe the metric.

    Replace the '@@@'s and the text in between with the name of the metric.
    -->
    <section>
      <title>@@@ Metric @@@</title>

      <para>

        <informaltable>
          <tgroup cols="2">
            <tbody>
              <row>
                <entry>Name</entry>
                <entry>
                  <para>
                    <!--
                    Name of the Metric and any known synonyms.
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Definition</entry>
                <entry>
                  <para>
                    <!--
                    The attributes of the entities that are measured using this
                    Metric, how the Metric is calculated, and from which
                    Primitive Metrics it is calculated.
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Goals</entry>
                <entry>
                  <para>
                    <!--
                    List of goals and questions related to this Metric. Also
                    some explanation as to why the Metric is being collected.
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Analysis Procedure</entry>
                <entry>
                  <para>
                    <!--
                    How the Metric is intended to be used.

                    Preconditions for the interpretation of the Metric; for
                    example, valid range of other metrics.

                    Target values or trends.

                    Models of analysis techniques and tools to be used.
                    
                    Implicit assumptions; for example, the environment or
                    models.
                    
                    Calibration procedures.
                    
                    Storage.
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Responsibilities</entry>
                <entry>
                  <para>
                    <!--
                    Who will collect and aggregate measurement data, prepare
                    the reports, and analyze the data?
                    -->
                  </para>
                </entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>

      </para>

    </section>

  </chapter><!--}}}-->

  <!--
  Enumerate the primitive metrics that are collected, automatically or
  manually, to compute the metrics.
  -->
  <chapter><!-- Primitive Metrics {{{-->
    <title>Primitive Metrics</title>

    <para>
    </para>

    <!--
    Create a new section for each metric and use the table included in the
    section to describe the metric.

    Replace the '@@@'s and the text in between with the name of the metric.
    -->
    <section>
      <title>@@@ Metric @@@</title>

      <para>

        <informaltable>
          <tgroup cols="2">
            <tbody>
              <row>
                <entry>Name</entry>
                <entry>
                  <para>
                    <!--
                    Name of the Primitive Metric.
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Definition</entry>
                <entry>
                  <para>
                    <!--
                    Unambiguous description of the metric in terms of the
                    project's environment.
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Collection Procedure</entry>
                <entry>
                  <para>
                    <!--
                    Description of the collection procedure.

                    Data collection tool and form to be used.

                    Points in the lifecycle when data are collected.

                    Verification procedure to be used.

                    Where will the data be stored, format, precision?
                    -->
                  </para>
                </entry>
              </row>
              <row>
                <entry>Responsibilities</entry>
                <entry>
                  <para>
                    <!--
                    Who is responsible for collecting and verifying the data?
                    -->
                  </para>
                </entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>

      </para>

    </section>

  </chapter><!--}}}-->

  <!--
  Computation methods, tables for estimates, detailed procedure as appropriate.
  -->
  <chapter><!-- Annexes {{{-->
    <title>Annexes</title>

    <para>
    </para>

  </chapter><!--}}}-->

</book><!--}}}-->

<!-- vim: set ts=2 sw=2 fo+=t et ff=unix filetype=docbkxml fdm=marker: -->

