You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-svn@forrest.apache.org by cr...@apache.org on 2007/04/11 04:03:34 UTC
svn commit: r527368 [1/6] - in
/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo:
./ docs/developer/useCases/ docs/user/useCases/ images/ skin/ skin/images/
svn-log/ useCases/
Author: crossley
Date: Tue Apr 10 19:03:32 2007
New Revision: 527368
URL: http://svn.apache.org/viewvc?view=rev&rev=527368
Log:
Deployment of docs for org.apache.forrest.plugin.input.projectInfo plugin (deployed by 'deploy-docs' target of plugin build script)
Modified:
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.rss
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.rss
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.2-dev.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.rss
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/all.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/changeLogFeatures.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/useCaseFeatures.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/useCaseFeatures.source.xml
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/user/useCases/all.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/user/useCases/changeLogFeatures.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/user/useCases/useCaseFeatures.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/user/useCases/useCaseFeatures.source.xml
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/images/project.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/index.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/linkmap.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/locationmap.xml
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/log.svn.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/releaseNotes_0.1.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/releaseNotes_0.2-dev.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/CommonMessages_es.xml
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-b-l-15-1body-2menu-3menu.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-b-r-15-1body-2menu-3menu.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-l-5-1header-2searchbox-3searchbox.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-l-5-1header-2tab-selected-3tab-selected.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-r-15-1body-2menu-3menu.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-r-5-1header-2searchbox-3searchbox.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-r-5-1header-2tab-selected-3tab-selected.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/skin/images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/svn-log/log.svn.xml
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/todo.html
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/useCases/changeLogFeatures.xml
forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/useCases/useCaseFeatures.xml
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.html?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.html Tue Apr 10 19:03:32 2007
@@ -77,7 +77,7 @@
|breadtrail
+-->
<div class="breadtrail">
-
+
</div>
<!--+
@@ -205,13 +205,13 @@
<div class="section">
<p>Changes are sorted by "type" and then chronologically with the most recent at the top. These symbols denote the various action types:<img class="icon" alt="add" src="images/add.jpg">=add, <img class="icon" alt="fix" src="images/fix.jpg">=fix, <img class="icon" alt="update" src="images/update.jpg">=update</p>
</div>
- <!-- Add new releases here -->
+<!-- Add new releases here -->
<a name="N10022"></a><a name="version_0.2-dev"></a>
<h2 class="underlined_10">Version 0.2-dev (not-released)</h2>
<div class="section">
-<p>See also the main
- <a href="http://forrest.apache.org/changes.html">changes</a>
+<p>
+ See also the main <a href="http://forrest.apache.org/changes.html">changes</a>
related to all plugins.
</p>
<a name="N1002E"></a><a name="Changes+to+the+Code+Base"></a>
@@ -375,7 +375,6 @@
<p>This is a list of all people who participated as committers:<br>David Crossley (DC), Juan Jose Pablos (jjp), Ross Gardler (RDG), Thorsten Scherler (TS).</p>
<p>This is a list of other contributors:<br>cyriaque dupoirieux.</p>
</div>
-
<a name="N10102"></a><a name="version_0.1"></a>
<h2 class="underlined_10">Version 0.1 (25 May 2005)</h2>
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.rss
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.rss?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.rss (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes.rss Tue Apr 10 19:03:32 2007
@@ -1,31 +1,32 @@
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">
-<rss version="0.91"><channel><title>Plugin: projectInfo input (0.2-dev) Changes</title><link>changes.html</link><description>Plugin: projectInfo input (0.2-dev) Changes</description><language>en-us</language>
-
+<rss version="0.91"><channel><title>Plugin: projectInfo input (0.2-dev) Changes</title><link>changes.html</link><description>Plugin: projectInfo input
+ (
+ 0.2-dev
+ ) Changes
+ </description><language>en-us</language>
+
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
- See also the main
- changes
+
+ See also the main changes
related to all plugins.
@@ -285,7 +286,6 @@
</description></item>
-
<item><title>code add</title><link>changes.html</link><description>code add
by
@@ -387,9 +387,7 @@
</description></item>
-
-
<item><title>code update
(bug FOR-977)
</title><link>changes.html</link><description>code update
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.html?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.html Tue Apr 10 19:03:32 2007
@@ -77,7 +77,7 @@
|breadtrail
+-->
<div class="breadtrail">
-
+
</div>
<!--+
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.rss
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.rss?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.rss (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.1.rss Tue Apr 10 19:03:32 2007
@@ -1,5 +1,9 @@
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">
-<rss version="0.91"><channel><title>Plugin: projectInfo input (0.1) Changes</title><link>changes.html</link><description>Plugin: projectInfo input (0.1) Changes</description><language>en-us</language>
+<rss version="0.91"><channel><title>Plugin: projectInfo input (0.1) Changes</title><link>changes.html</link><description>Plugin: projectInfo input
+ (
+ 0.1
+ ) Changes
+ </description><language>en-us</language>
<item><title>code add</title><link>changes.html</link><description>code add
by
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.2-dev.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.2-dev.html?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.2-dev.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_0.2-dev.html Tue Apr 10 19:03:32 2007
@@ -77,7 +77,7 @@
|breadtrail
+-->
<div class="breadtrail">
-
+
</div>
<!--+
@@ -188,8 +188,8 @@
<a name="N1001F"></a><a name="version_0.2-dev"></a>
<h2 class="underlined_10">Version 0.2-dev (not-released)</h2>
<div class="section">
-<p>See also the main
- <a href="http://forrest.apache.org/changes.html">changes</a>
+<p>
+ See also the main <a href="http://forrest.apache.org/changes.html">changes</a>
related to all plugins.
</p>
<a name="N1002B"></a><a name="Changes+to+the+Code+Base"></a>
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.html?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.html Tue Apr 10 19:03:32 2007
@@ -77,7 +77,7 @@
|breadtrail
+-->
<div class="breadtrail">
-
+
</div>
<!--+
@@ -188,8 +188,8 @@
<a name="N1001F"></a><a name="version_0.2-dev"></a>
<h2 class="underlined_10">Version 0.2-dev (not-released)</h2>
<div class="section">
-<p>See also the main
- <a href="http://forrest.apache.org/changes.html">changes</a>
+<p>
+ See also the main <a href="http://forrest.apache.org/changes.html">changes</a>
related to all plugins.
</p>
<a name="N1002B"></a><a name="Changes+to+the+Code+Base"></a>
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.rss
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.rss?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.rss (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/changes_current.rss Tue Apr 10 19:03:32 2007
@@ -1,8 +1,12 @@
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">
-<rss version="0.91"><channel><title>Plugin: projectInfo input (0.2-dev) Changes</title><link>changes.html</link><description>Plugin: projectInfo input (0.2-dev) Changes</description><language>en-us</language>
+<rss version="0.91"><channel><title>Plugin: projectInfo input (0.2-dev) Changes</title><link>changes.html</link><description>Plugin: projectInfo input
+ (
+ 0.2-dev
+ ) Changes
+ </description><language>en-us</language>
- See also the main
- changes
+
+ See also the main changes
related to all plugins.
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/all.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/all.html?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/all.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/all.html Tue Apr 10 19:03:32 2007
@@ -77,7 +77,7 @@
|breadtrail
+-->
<div class="breadtrail">
-
+
</div>
<!--+
@@ -260,14 +260,18 @@
<div class="section">
<a name="N1000B"></a><a name="Write+status.xml+File"></a>
<h3 class="underlined_5">Write status.xml File</h3>
-<p>Status.xml if an XML file that records the actions that have been taken in each release
- of a project. You can then generate a Change Log from that file using the projectInfo
- plugin.</p>
+<p>
+ Status.xml if an XML file that records the actions that have been taken
+ in each release of a project. You can then generate a Change Log from
+ that file using the projectInfo plugin.
+ </p>
<a name="N10014"></a><a name="Justification"></a>
<h4>Justification</h4>
-<p>Provide a central location and a semi-structured format for recording
- actions taken during project development. This file can then be used to
- generate various views on the changes in a release. For example:</p>
+<p>
+ Provide a central location and a semi-structured format for recording
+ actions taken during project development. This file can then be used
+ to generate various views on the changes in a release. For example:
+ </p>
<ul>
<li>Changes between releases</li>
@@ -285,38 +289,30 @@
<strong>Create/open a status.xml file</strong>
</li>
-
<li>
<strong>Create a developer list</strong>
</li>
-
-
<li>
<strong>Create a contexts list</strong>
</li>
-
<li>
<strong>Create a changes element</strong>
</li>
-
<li>
<strong>Create a release element</strong>
</li>
-
-
+
<li>
<strong>Create a notes element</strong>
</li>
-
-
+
<li>
<strong>Add actions taken during the development cycle</strong>
</li>
-
-
+
<li>
<strong>Generate the change log</strong>
</li>
@@ -332,39 +328,48 @@
<tr>
<td>1. Create/open a status.xml file</td><td>
-<p>In your favourite XML editor either create a new file
- or open an existing status.xml file. The default location of these files
- within a Forrest content object is in the project root. This file should
- conform to one of the status.xml schemas. The root element for this
- document is <span class="codefrag">status</span>.</p>
+<p>
+ In your favourite XML editor either create a new file or open an
+ existing status.xml file. The default location of these files within
+ a Forrest content object is in the project root. This file should
+ conform to one of the status.xml schemas. The root element for this
+ document is <span class="codefrag">status</span>.
+ </p>
</td><td>You have either a blank status.xml document or an existing one ready for editing.</td><td>Implemented</td>
</tr>
-
<tr>
<td>2. Create a developer list</td><td>
-<p>In order to attribute changes to a specific developer it is neceessary to create
- a <span class="codefrag">developers</span> element. Within this element you should add a single
- <span class="codefrag">person</span> element for each develop who works on the project.</p>
+<p>
+ In order to attribute changes to a specific developer it is
+ neceessary to create a <span class="codefrag">developers</span> element. Within this
+ element you should add a single <span class="codefrag">person</span> element for each
+ develop who works on the project.
+ </p>
</td><td>Each developer is identified in the status.xml file.</td><td>Implemented</td>
</tr>
-
-
<tr>
<td>3. Create a contexts list</td><td>
-<p>Each action within a release is given a context to help classify changes.
- When reports are created the context of an action is used to create a more
- readable report in which similar actions are grouped together. You can
- specify any contexts you like within the <span class="codefrag">contexts</span> element.</p>
+<p>
+ Each action within a release is given a context to help classify
+ changes. When reports are created the context of an action is used
+ to create a more readable report in which similar actions are
+ grouped together. You can specify any contexts you like within the
+ <span class="codefrag">contexts</span> element.
+ </p>
+
-<p>Common contexts used in an software development project are:</p>
+<p>
+ Common contexts used in an software development project are:
+ </p>
<pre class="code">
+
<contexts>
<context id="code" title="Changes to the Code Base"/>
<context id="docs" title="Changes to Documentation"/>
@@ -372,80 +377,97 @@
<context id="design" title="Changes to Design"/>
<context id="build" title="Changes to Build"/>
</contexts>
+
</pre>
</td><td>The status.xml file describes the sufficient contexts to group common
actions together.</td><td>Implemented</td>
</tr>
-
<tr>
<td>4. Create a changes element</td><td>
-<p>Actions that describe the changed in a release are placed within
- a <span class="codefrag">changes</span>.</p>
+<p>
+ Actions that describe the changed in a release are placed within a
+ <span class="codefrag">changes</span>.
+ </p>
</td><td>Status.xml holds an changes element that will group all release
information.</td><td>Implemented</td>
</tr>
-
<tr>
<td>5. Create a release element</td><td>
-<p>The details of each release are enclosed within a <span class="codefrag">release</span> element,
- so you need to create that now.</p>
+<p>
+ The details of each release are enclosed within a
+ <span class="codefrag">release</span> element, so you need to create that now.
+ </p>
</td><td>You have the container for your current development release.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>6. Create a notes element</td><td>
-
-<p>Each release can have a <span class="codefrag">notes</span> section. This is used
- to provide descriptive text at the start of many reports. The notes
- should describe the release in fairly high level detail, it should
- not describe any change descriptions, these will be added in the
- next step.</p>
+<p>
+ Each release can have a <span class="codefrag">notes</span> section. This is used to
+ provide descriptive text at the start of many reports. The notes
+ should describe the release in fairly high level detail, it should
+ not describe any change descriptions, these will be added in the
+ next step.
+ </p>
+
</td><td>You have a user focussed description of the project and this release.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>7. Add actions taken during the development cycle</td><td>
-
-<p>During the development cycle for the release <span class="codefrag">action</span> elements
- should be added for each significant contribution to the release.</p>
-
-
-<p>If the change is of particular significance and you woul dlike it to appear
- in the release notes generated by the projectInfo plugin you should set the
- <span class="codefrag">importance</span> attribute to <span class="codefrag">"high"</span>.</p>
+<p>
+ During the development cycle for the release <span class="codefrag">action</span>
+ elements should be added for each significant contribution to the
+ release.
+ </p>
+
+
+<p>
+ If the change is of particular significance and you woul dlike it to
+ appear in the release notes generated by the projectInfo plugin you
+ should set the <span class="codefrag">importance</span> attribute to
+ <span class="codefrag">"high"</span>.
+ </p>
+
</td><td>Each significant change in this development cycle is describe in a
<span class="codefrag">action</span> element.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>8. Generate the change log</td><td>
-
-<p>To generate a changelog from your status.xml file you need to request
- <span class="codefrag">/changes.html</span> or <span class="codefrag">changes.pdf</span> or whatever format
- you have enabled within Forrest using output plugins.</p>
-
-
-<p>Note that the projectInfo plugin provides a special RSS output format
- of. Technically, this should not be part of an input plugin and therefore
- it may be moved at a later date. However, you will always be able to
- generate the RSS feed by requesting <span class="codefrag">changes.rss</span>.</p>
-
-
-<p>You can generate a change log for a specific version by specifying a
- version number in the request, for example, <span class="codefrag">changes_0.1.html</span>.</p>
+<p>
+ To generate a changelog from your status.xml file you need to
+ request <span class="codefrag">/changes.html</span> or <span class="codefrag">changes.pdf</span> or
+ whatever format you have enabled within Forrest using output
+ plugins.
+ </p>
+
+
+<p>
+ Note that the projectInfo plugin provides a special RSS output
+ format of. Technically, this should not be part of an input plugin
+ and therefore it may be moved at a later date. However, you will
+ always be able to generate the RSS feed by requesting
+ <span class="codefrag">changes.rss</span>.
+ </p>
+
+
+<p>
+ You can generate a change log for a specific version by specifying a
+ version number in the request, for example,
+ <span class="codefrag">changes_0.1.html</span>.
+ </p>
+
</td><td>Your project is able to generate a changelog.</td><td>Implemented</td>
</tr>
@@ -463,14 +485,11 @@
</td>
</tr>
-
<tr>
<td>2. Create a developer list</td><td>
<br>
</td>
</tr>
-
-
<tr>
<td>3. Create a contexts list</td><td>
@@ -478,35 +497,30 @@
</td>
</tr>
-
<tr>
<td>4. Create a changes element</td><td>
<br>
</td>
</tr>
-
<tr>
<td>5. Create a release element</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>6. Create a notes element</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>7. Add actions taken during the development cycle</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>8. Generate the change log</td><td>
<br>
@@ -520,16 +534,24 @@
<div class="section">
<a name="N10144"></a><a name="Write+Use+Case+Documentation"></a>
<h3 class="underlined_5">Write Use Case Documentation</h3>
-<p>Write semi-structured use case documents so that they can be reused in a variety of ways.
- This use case describews a process for writing such documents. This document is derived from
- such a <a href="useCaseFeatures.source.xml">source document</a>.</p>
+<p>
+ Write semi-structured use case documents so that they can be reused in a
+ variety of ways. This use case describews a process for writing such
+ documents. This document is derived from such a
+ <a href="useCaseFeatures.source.xml">source document</a>.
+ </p>
<a name="N10151"></a><a name="Justification-N10151"></a>
<h4>Justification</h4>
-<p>A use case describes a unit of work. It is typically used in the design
- stages of a software project. It is very useful for describing what an applicaiton must
- do and what patchs through the system can be taken.</p>
-<p>By bringing this information together in a semi-structured document we can use it in many
- different ways. For example:</p>
+<p>
+ A use case describes a unit of work. It is typically used in the
+ design stages of a software project. It is very useful for describing
+ what an applicaiton must do and what patchs through the system can be
+ taken.
+ </p>
+<p>
+ By bringing this information together in a semi-structured document we
+ can use it in many different ways. For example:
+ </p>
<ul>
<li>Requirements Documentation</li>
@@ -550,43 +572,35 @@
<li>
<strong>Create/open a Use Case file</strong>
</li>
-
<li>
<strong>Create a new use case</strong>
</li>
-
-
+
<li>
<strong>Describe the overall objective of the use case</strong>
</li>
-
-
+
<li>
<strong>Define each step in the Use Case</strong>
</li>
-
-
+
<li>
<strong>Descripbe the step</strong>
</li>
-
-
+
<li>
<strong>Describe the expected results</strong>
</li>
-
-
+
<li>
<strong>Add "fixme" notes</strong> (Optional)</li>
-
-
+
<li>
<strong>Add alternatives</strong> (Optional)</li>
-
-
+
<li>
-<strong>Write Implementation Notes</strong> (Optional)</li>
+<strong>Write Implementation Notes</strong> (Optional)</li>
</ol>
<a name="N1019E"></a><a name="Details-N1019E"></a>
@@ -597,152 +611,172 @@
</tr>
<tr>
-<td>1. Create/open a Use Case file</td><td>In your favourite XML editor either create a new file
- or open an existing use case file. The default location of these files
- within a Forrest content object is <span class="codefrag">/content/documentation/useCases/**.xml</span>
+<td>1. Create/open a Use Case file</td><td>
+ In your favourite XML editor either create a new file or open an
+ existing use case file. The default location of these files within a
+ Forrest content object is
+ <span class="codefrag">/content/documentation/useCases/**.xml</span>
</td><td>You have either a blank use case document or an existing one ready for editing.</td><td>
Implemented with fixmes:-<br>
High: 1<br>
</td>
</tr>
-
<tr>
<td>2. Create a new use case</td><td>
-<p>A use case is enclosed within a <span class="codefrag">useCase</span> element.
- Each use case should be given a brief <span class="codefrag">title</span> to describe it.</p>
-
+<p>
+ A use case is enclosed within a <span class="codefrag">useCase</span> element. Each
+ use case should be given a brief <span class="codefrag">title</span> to describe it.
+ </p>
</td><td>You have the container for your new use case.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>3. Describe the overall objective of the use case</td><td>
-
-<p>Each use case should be described in terms of:</p>
-
+
+<p>
+ Each use case should be described in terms of:
+ </p>
+
<ul>
-
+
<li>The objective</li>
-
+
<li>The expected results</li>
-
-<li>The justification</li>
+<li>The justification</li>
+
</ul>
-
-<p>This information should be placed in the <span class="codefrag">description</span> element
- of your use case. This node allows any XDoc markup and therefore you are
- reasonably free to use whatever formatting or images are needed to convey the
- important details most efficiently.</p>
+<p>
+ This information should be placed in the <span class="codefrag">description</span>
+ element of your use case. This node allows any XDoc markup and
+ therefore you are reasonably free to use whatever formatting or
+ images are needed to convey the important details most efficiently.
+ </p>
+
</td><td>You have a use case that is described sufficiently well for an average user of the end system
to understand its purpose.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>4. Define each step in the Use Case</td><td>
-
-<p>Each use case will be subdivided into one or more steps that must be carried out
- in order to complete the task. Each of these steps is defined within a <span class="codefrag">step</span>
- element which are chilren of a <span class="codefrag">steps</span> element.</p>
+<p>
+ Each use case will be subdivided into one or more steps that must be
+ carried out in order to complete the task. Each of these steps is
+ defined within a <span class="codefrag">step</span> element which are chilren of a
+ <span class="codefrag">steps</span> element.
+ </p>
+
</td><td></td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>5. Descripbe the step</td><td>
-
-<p>Each step has a title and a description. The description should provide enough information
- for a user to complete the task and for a developer to implement support for the user in that
- task.</p>
+
+<p>
+ Each step has a title and a description. The description should
+ provide enough information for a user to complete the task and for a
+ developer to implement support for the user in that task.
+ </p>
-
-<p>In addition each step can be described as required or optional. By default a step is assumed
- be required. To set it to optional add a <span class="codefrag">required="false"</span> attribute to the
- <span class="codefrag">step</span> element.</p>
+<p>
+ In addition each step can be described as required or optional. By
+ default a step is assumed be required. To set it to optional add a
+ <span class="codefrag">required="false"</span> attribute to the <span class="codefrag">step</span>
+ element.
+ </p>
+
</td><td>A user will be able to follow instructions on how to carry out the step.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>6. Describe the expected results</td><td>
-
-<p>Provide, within a <span class="codefrag">result</span> a brief description of the expected results from
- this step. This should summarise what state the application will be in once this use case
- has been performed.</p>
+<p>
+ Provide, within a <span class="codefrag">result</span> a brief description of the
+ expected results from this step. This should summarise what state
+ the application will be in once this use case has been performed.
+ </p>
+
</td><td>You will have provided enough information to allow developers to test the functionality and
users to identify when a step has been succesfully completed.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>7. Add "fixme" notes<br>(Optional)</td><td>
-
-<p>A fixme note is enclosed within a <span class="codefrag">fixme</span> element. It describes something that
- remains to be done within this step. Each fixme has a priority attribute which can take one of
- of the followin values:</p>
-
-
+
+<p>
+ A fixme note is enclosed within a <span class="codefrag">fixme</span> element. It
+ describes something that remains to be done within this step. Each
+ fixme has a priority attribute which can take one of of the followin
+ values:
+ </p>
+
<ul>
-
+
<li>Enhancement - a nice to have ehancment that may or may not be implemented.</li>
-
+
<li>Low - this is considered an important addition to the use case, but everything works without it.</li>
-
+
<li>High - this is an important addition. Everything works without it, but having this implmeneted would
improve the application considerably.</li>
-
+
<li>Major - this is nor preventing work that utilises the use case, but it is considered a requirement
for the next release since it adds key functionlaity.</li>
-
-<li>Blocker - this is preventing the correct operation of this use case and must be implmeneted ASAP</li>
+<li>Blocker - this is preventing the correct operation of this use case and must be implmeneted ASAP</li>
+
</ul>
-
-
-<p>Although this step is optional, it is good practice to allways add a
- <span class="codefrag"><fixme priority="blocker">Not yet implemented</fixme></span>
- element to all new steps. This is becuase these nodes will be used to build a
- functionality matrix later on.</p>
+<p>
+ Although this step is optional, it is good practice to allways add a
+ <span class="codefrag"><fixme priority="blocker">Not yet
+ implemented</fixme></span> element to all new steps. This is
+ becuase these nodes will be used to build a functionality matrix
+ later on.
+ </p>
+
</td><td>Users will be able to understand to what degree a step is implemented and developers will be able to
see what remains to be done.</td><td>
Implemented with fixmes:-<br>
</td>
</tr>
-
-
+
<tr>
<td>8. Add alternatives<br>(Optional)</td><td>
-
-<p>Sometimes there will be alternative paths through each step. These can be described in an
- <span class="codefrag">alternatives</span> element that allows free-form XDoc content. However, please be
- careful, if an alternative is more than a simple variation you may want to consider a
- whole new use case for the alternative.</p>
+<p>
+ Sometimes there will be alternative paths through each step. These
+ can be described in an <span class="codefrag">alternatives</span> element that allows
+ free-form XDoc content. However, please be careful, if an
+ alternative is more than a simple variation you may want to consider
+ a whole new use case for the alternative.
+ </p>
+
</td><td>Minor variations in the path through a use case will be documented for your users.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>9. Write Implementation Notes<br>(Optional)</td><td>
-
-<p>Developer implementation notes for each of the steps should be added either when writing the
- initial use case or later during the development phases of the use case. These notes are for technical readers
- and are intended to help those who come after the initial author to get a starting point when inspecting how
- a feature is implemented. It is not intended that these notes will contain full implementation details, only an
- overview should be provided.</p>
+<p>
+ Developer implementation notes for each of the steps should be added
+ either when writing the initial use case or later during the
+ development phases of the use case. These notes are for technical
+ readers and are intended to help those who come after the initial
+ author to get a starting point when inspecting how a feature is
+ implemented. It is not intended that these notes will contain full
+ implementation details, only an overview should be provided.
+ </p>
+
</td><td>A technical reader will be able to gain a baisc understanding of how each step is implemented in the
application.</td><td>Implemented</td>
-</tr>
+</tr>
</table>
<a name="N10273"></a><a name="Implementation+Notes-N10273"></a>
@@ -757,73 +791,69 @@
<br>
<div class="fixme">
<div class="label">Fixme (High)</div>
-<div class="content">Aggregate all documents in the useCases directory to provide
- ne large document describing all use cases.</div>
+<div class="content">
+ Aggregate all documents in the useCases directory to provide ne large
+ document describing all use cases.
+ </div>
</div>
</td>
</tr>
-
<tr>
<td>2. Create a new use case</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>3. Describe the overall objective of the use case</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>4. Define each step in the Use Case</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>5. Descripbe the step</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>6. Describe the expected results</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>7. Add "fixme" notes</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>8. Add alternatives</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>9. Write Implementation Notes</td><td>
<br>
</td>
-</tr>
+</tr>
</table>
<a name="N102B8"></a><a name="Generate+Use+Case+Documentation+for+Developers"></a>
<h3 class="underlined_5">Generate Use Case Documentation for Developers</h3>
-<p>Generate a complete list of all use cases for a project in a format useful to
- developers of the application. This list is to include:</p>
+<p>
+ Generate a complete list of all use cases for a project in a format
+ useful to developers of the application. This list is to include:
+ </p>
<ul>
<li>a description of the use case</li>
@@ -836,20 +866,26 @@
<li>details of common alternatives in each step</li>
-<li>implementation notes for each step</li>
+<li>implementation notes for each step</li>
</ul>
<a name="N102D6"></a><a name="Justification-N102D6"></a>
<h4>Justification</h4>
-<p>A use case describes a unit of work. It is typically used in the design
- stages of a software project, however, they can often be useful in creating
- user documentaiton. Especially when they describe user interface functionality.</p>
+<p>
+ A use case describes a unit of work. It is typically used in the
+ design stages of a software project, however, they can often be useful
+ in creating user documentaiton. Especially when they describe user
+ interface functionality.
+ </p>
<div class="warning">
<div class="label">Warning</div>
-<div class="content">Unfortunately this use case document does not currently cover all functions
- of the plugin since this functionlaity was added after many other features. Whilst you
- are exploring this feature, why not add a use case to the plugin and submit a patch
- so that those coming after you can enjoy more complete documentation.</div>
+<div class="content">
+ Unfortunately this use case document does not currently cover all
+ functions of the plugin since this functionlaity was added after many
+ other features. Whilst you are exploring this feature, why not add a
+ use case to the plugin and submit a patch so that those coming after
+ you can enjoy more complete documentation.
+ </div>
</div>
<a name="N102E3"></a><a name="Summary-N102E3"></a>
<h4>Summary</h4>
@@ -871,8 +907,7 @@
<td>1. Make HTTP request</td><td>
<p>
- Request
- http://localhost:8888/docs/developer/useCases.xml
+ Request http://localhost:8888/docs/developer/useCases.xml
</p>
</td><td>
@@ -898,19 +933,28 @@
<tr>
<td>1. Make HTTP request</td><td>
-<p>The source document for use cases is, by default, called <span class="codefrag">useCases.xml</span> and is
- located in the root of the projects xdocs directory.</p>
+<p>
+ The source document for use cases is, by default, called
+ <span class="codefrag">useCases.xml</span> and is located in the root of the
+ projects xdocs directory.
+ </p>
-<p>The URL space <span class="codefrag">docs/**/useCases.xml</span> is reserved for the projectInfo plugin. A request to
- /docs/developer/useCases.xml results in the useCases.xml file being translated into an XDoc as per
- the usual forrest processing. See the input.xmap file fo this plugin,</p>
+<p>
+ The URL space <span class="codefrag">docs/**/useCases.xml</span> is reserved for
+ the projectInfo plugin. A request to /docs/developer/useCases.xml
+ results in the useCases.xml file being translated into an XDoc as
+ per the usual forrest processing. See the input.xmap file fo this
+ plugin,
+ </p>
<br>
<div class="fixme">
<div class="label">Fixme (High)</div>
-<div class="content">Make the summary optional - already added
- $includeImplementationNotes parameter to stylesheet. Need to pass value form sitemap.</div>
+<div class="content">
+ Make the summary optional - already added $includeImplementationNotes
+ parameter to stylesheet. Need to pass value form sitemap.
+ </div>
</div>
</td>
</tr>
@@ -918,7 +962,10 @@
</table>
<a name="N10332"></a><a name="Generate+Use+Case+Documentation+for+Users"></a>
<h3 class="underlined_5">Generate Use Case Documentation for Users</h3>
-<p>Generate a complete list of all use cases for a project. This list is to include:</p>
+<p>
+ Generate a complete list of all use cases for a project. This list is to
+ include:
+ </p>
<ul>
<li>a description of the use case</li>
@@ -934,15 +981,21 @@
</ul>
<a name="N1034D"></a><a name="Justification-N1034D"></a>
<h4>Justification</h4>
-<p>A use case describes a unit of work. It is typically used in the design
- stages of a software project, however, they can often be useful in creating
- user documentaiton. Especially when they describe user interface functionality.</p>
+<p>
+ A use case describes a unit of work. It is typically used in the
+ design stages of a software project, however, they can often be useful
+ in creating user documentaiton. Especially when they describe user
+ interface functionality.
+ </p>
<div class="warning">
<div class="label">Warning</div>
-<div class="content">Unfortunately the use case document does not currently cover all functions
- of the plugin since this functionlaity was added after many other features. Whilst you
- are exploring this feature, why not add a use case to the plugin and submit a patch
- so that those coming after you can enjoy more complete documentation.</div>
+<div class="content">
+ Unfortunately the use case document does not currently cover all
+ functions of the plugin since this functionlaity was added after many
+ other features. Whilst you are exploring this feature, why not add a
+ use case to the plugin and submit a patch so that those coming after
+ you can enjoy more complete documentation.
+ </div>
</div>
<a name="N1035A"></a><a name="Summary-N1035A"></a>
<h4>Summary</h4>
@@ -964,8 +1017,7 @@
<td>1. Make HTTP request</td><td>
<p>
- Request
- http://localhost:8888/docs/user/useCases.xml
+ Request http://localhost:8888/docs/user/useCases.xml
</p>
</td><td>
@@ -992,23 +1044,33 @@
<tr>
<td>1. Make HTTP request</td><td>
-<p>The source document for use cases is, by default, called <span class="codefrag">useCases.xml</span> and is
- located in the root of the projects xdocs directory.</p>
+<p>
+ The source document for use cases is, by default, called
+ <span class="codefrag">useCases.xml</span> and is located in the root of the
+ projects xdocs directory.
+ </p>
-<p>The URL space <span class="codefrag">docs/**/useCases.xml</span> is reserved for the projectInfo plugin. A request to
- /docs/user/useCases.xml results in the useCases.xml file being translated into an XDoc as per
- the usual forrest processing, see input.xmap for more details.</p>
+<p>
+ The URL space <span class="codefrag">docs/**/useCases.xml</span> is reserved for
+ the projectInfo plugin. A request to /docs/user/useCases.xml
+ results in the useCases.xml file being translated into an XDoc as
+ per the usual forrest processing, see input.xmap for more details.
+ </p>
<br>
<div class="fixme">
<div class="label">Fixme (High)</div>
-<div class="content">Enable the retrieval of a specific use case rather than all at once.</div>
+<div class="content">
+ Enable the retrieval of a specific use case rather than all at once.
+ </div>
</div>
<div class="fixme">
<div class="label">Fixme (Low)</div>
-<div class="content">Make the summary optional - there is a switch in the XSL for this, just need to pass a property
- from the XMAP</div>
+<div class="content">
+ Make the summary optional - there is a switch in the XSL for this,
+ just need to pass a property from the XMAP
+ </div>
</div>
</td>
</tr>
@@ -1016,13 +1078,18 @@
</table>
<a name="N103AE"></a><a name="Generate+a+Functionality+Matrix"></a>
<h3 class="underlined_5">Generate a Functionality Matrix</h3>
-<p>If a use case document is correcly marked up with <span class="codefrag">fixme</span> elements it is possible
- to create a functionality matrix for each use case. This will show how complete the implementation
- of a use case is.</p>
-<p>A table can be created which shows each of the steps in a use case, each step can be given a
- count for the bumber of fixme items outstanding on each of the steps. Furthermore, since each
- <span class="codefrag">fixme</span> is given a priority we can clearly indicate which use cases are operational an
- hich are not.</p>
+<p>
+ If a use case document is correcly marked up with <span class="codefrag">fixme</span>
+ elements it is possible to create a functionality matrix for each use
+ case. This will show how complete the implementation of a use case is.
+ </p>
+<p>
+ A table can be created which shows each of the steps in a use case, each
+ step can be given a count for the bumber of fixme items outstanding on
+ each of the steps. Furthermore, since each <span class="codefrag">fixme</span> is given a
+ priority we can clearly indicate which use cases are operational an hich
+ are not.
+ </p>
<a name="N103C0"></a><a name="Summary-N103C0"></a>
<h4>Summary</h4>
<ol class="steps">
@@ -1050,14 +1117,16 @@
</td><td>
<p>
- An XDoc is created that lists the steps in each use case and identifies the status
- of each use case.
+ An XDoc is created that lists the steps in each use case and
+ identifies the status of each use case.
</p>
</td><td>
<div class="warning">
<div class="label">Warning</div>
-<div class="content">Not Implemented</div>
+<div class="content">
+ Not Implemented
+ </div>
</div>
Blockers: 1<br>
</td>
@@ -1074,19 +1143,29 @@
<tr>
<td>1. Make HTTP request</td><td>
-<p>The source document for use cases is, by default, called <span class="codefrag">useCases.xml</span> and is
- located in the root of the projects xdocs directory.</p>
+<p>
+ The source document for use cases is, by default, called
+ <span class="codefrag">useCases.xml</span> and is located in the root of the
+ projects xdocs directory.
+ </p>
-<p>The URL space <span class="codefrag">docs/**/useCases.xml</span> is reserved for the projectInfo plugin. A request to
- /docs/developer/featureMatrix/useCases.xml results in the useCases.xml file being translated into an XDoc as per
- the usual forrest processing. See the input.xmap file fo this plugin,</p>
+<p>
+ The URL space <span class="codefrag">docs/**/useCases.xml</span> is reserved for
+ the projectInfo plugin. A request to
+ /docs/developer/featureMatrix/useCases.xml results in the
+ useCases.xml file being translated into an XDoc as per the usual
+ forrest processing. See the input.xmap file fo this plugin,
+ </p>
<br>
<div class="fixme">
<div class="label">Fixme (Blocker)</div>
-<div class="content">Not Implemented Yet - although the user and dev use case documents
- do show the status of each step in the details table and implementation notes.</div>
+<div class="content">
+ Not Implemented Yet - although the user and dev use case documents do
+ show the status of each step in the details table and implementation
+ notes.
+ </div>
</div>
</td>
</tr>
Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/changeLogFeatures.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/changeLogFeatures.html?view=diff&rev=527368&r1=527367&r2=527368
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/changeLogFeatures.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.input.projectInfo/docs/developer/useCases/changeLogFeatures.html Tue Apr 10 19:03:32 2007
@@ -77,7 +77,7 @@
|breadtrail
+-->
<div class="breadtrail">
-
+
</div>
<!--+
@@ -190,14 +190,18 @@
<div class="section">
<a name="N1000B"></a><a name="Write+status.xml+File"></a>
<h3 class="underlined_5">Write status.xml File</h3>
-<p>Status.xml if an XML file that records the actions that have been taken in each release
- of a project. You can then generate a Change Log from that file using the projectInfo
- plugin.</p>
+<p>
+ Status.xml if an XML file that records the actions that have been taken
+ in each release of a project. You can then generate a Change Log from
+ that file using the projectInfo plugin.
+ </p>
<a name="N10014"></a><a name="Justification"></a>
<h4>Justification</h4>
-<p>Provide a central location and a semi-structured format for recording
- actions taken during project development. This file can then be used to
- generate various views on the changes in a release. For example:</p>
+<p>
+ Provide a central location and a semi-structured format for recording
+ actions taken during project development. This file can then be used
+ to generate various views on the changes in a release. For example:
+ </p>
<ul>
<li>Changes between releases</li>
@@ -215,38 +219,30 @@
<strong>Create/open a status.xml file</strong>
</li>
-
<li>
<strong>Create a developer list</strong>
</li>
-
-
<li>
<strong>Create a contexts list</strong>
</li>
-
<li>
<strong>Create a changes element</strong>
</li>
-
<li>
<strong>Create a release element</strong>
</li>
-
-
+
<li>
<strong>Create a notes element</strong>
</li>
-
-
+
<li>
<strong>Add actions taken during the development cycle</strong>
</li>
-
-
+
<li>
<strong>Generate the change log</strong>
</li>
@@ -262,39 +258,48 @@
<tr>
<td>1. Create/open a status.xml file</td><td>
-<p>In your favourite XML editor either create a new file
- or open an existing status.xml file. The default location of these files
- within a Forrest content object is in the project root. This file should
- conform to one of the status.xml schemas. The root element for this
- document is <span class="codefrag">status</span>.</p>
+<p>
+ In your favourite XML editor either create a new file or open an
+ existing status.xml file. The default location of these files within
+ a Forrest content object is in the project root. This file should
+ conform to one of the status.xml schemas. The root element for this
+ document is <span class="codefrag">status</span>.
+ </p>
</td><td>You have either a blank status.xml document or an existing one ready for editing.</td><td>Implemented</td>
</tr>
-
<tr>
<td>2. Create a developer list</td><td>
-<p>In order to attribute changes to a specific developer it is neceessary to create
- a <span class="codefrag">developers</span> element. Within this element you should add a single
- <span class="codefrag">person</span> element for each develop who works on the project.</p>
+<p>
+ In order to attribute changes to a specific developer it is
+ neceessary to create a <span class="codefrag">developers</span> element. Within this
+ element you should add a single <span class="codefrag">person</span> element for each
+ develop who works on the project.
+ </p>
</td><td>Each developer is identified in the status.xml file.</td><td>Implemented</td>
</tr>
-
-
<tr>
<td>3. Create a contexts list</td><td>
-<p>Each action within a release is given a context to help classify changes.
- When reports are created the context of an action is used to create a more
- readable report in which similar actions are grouped together. You can
- specify any contexts you like within the <span class="codefrag">contexts</span> element.</p>
+<p>
+ Each action within a release is given a context to help classify
+ changes. When reports are created the context of an action is used
+ to create a more readable report in which similar actions are
+ grouped together. You can specify any contexts you like within the
+ <span class="codefrag">contexts</span> element.
+ </p>
+
-<p>Common contexts used in an software development project are:</p>
+<p>
+ Common contexts used in an software development project are:
+ </p>
<pre class="code">
+
<contexts>
<context id="code" title="Changes to the Code Base"/>
<context id="docs" title="Changes to Documentation"/>
@@ -302,80 +307,97 @@
<context id="design" title="Changes to Design"/>
<context id="build" title="Changes to Build"/>
</contexts>
+
</pre>
</td><td>The status.xml file describes the sufficient contexts to group common
actions together.</td><td>Implemented</td>
</tr>
-
<tr>
<td>4. Create a changes element</td><td>
-<p>Actions that describe the changed in a release are placed within
- a <span class="codefrag">changes</span>.</p>
+<p>
+ Actions that describe the changed in a release are placed within a
+ <span class="codefrag">changes</span>.
+ </p>
</td><td>Status.xml holds an changes element that will group all release
information.</td><td>Implemented</td>
</tr>
-
<tr>
<td>5. Create a release element</td><td>
-<p>The details of each release are enclosed within a <span class="codefrag">release</span> element,
- so you need to create that now.</p>
+<p>
+ The details of each release are enclosed within a
+ <span class="codefrag">release</span> element, so you need to create that now.
+ </p>
</td><td>You have the container for your current development release.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>6. Create a notes element</td><td>
-
-<p>Each release can have a <span class="codefrag">notes</span> section. This is used
- to provide descriptive text at the start of many reports. The notes
- should describe the release in fairly high level detail, it should
- not describe any change descriptions, these will be added in the
- next step.</p>
+<p>
+ Each release can have a <span class="codefrag">notes</span> section. This is used to
+ provide descriptive text at the start of many reports. The notes
+ should describe the release in fairly high level detail, it should
+ not describe any change descriptions, these will be added in the
+ next step.
+ </p>
+
</td><td>You have a user focussed description of the project and this release.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>7. Add actions taken during the development cycle</td><td>
-
-<p>During the development cycle for the release <span class="codefrag">action</span> elements
- should be added for each significant contribution to the release.</p>
-
-
-<p>If the change is of particular significance and you woul dlike it to appear
- in the release notes generated by the projectInfo plugin you should set the
- <span class="codefrag">importance</span> attribute to <span class="codefrag">"high"</span>.</p>
+<p>
+ During the development cycle for the release <span class="codefrag">action</span>
+ elements should be added for each significant contribution to the
+ release.
+ </p>
+
+
+<p>
+ If the change is of particular significance and you woul dlike it to
+ appear in the release notes generated by the projectInfo plugin you
+ should set the <span class="codefrag">importance</span> attribute to
+ <span class="codefrag">"high"</span>.
+ </p>
+
</td><td>Each significant change in this development cycle is describe in a
<span class="codefrag">action</span> element.</td><td>Implemented</td>
</tr>
-
-
+
<tr>
<td>8. Generate the change log</td><td>
-
-<p>To generate a changelog from your status.xml file you need to request
- <span class="codefrag">/changes.html</span> or <span class="codefrag">changes.pdf</span> or whatever format
- you have enabled within Forrest using output plugins.</p>
-
-
-<p>Note that the projectInfo plugin provides a special RSS output format
- of. Technically, this should not be part of an input plugin and therefore
- it may be moved at a later date. However, you will always be able to
- generate the RSS feed by requesting <span class="codefrag">changes.rss</span>.</p>
-
-
-<p>You can generate a change log for a specific version by specifying a
- version number in the request, for example, <span class="codefrag">changes_0.1.html</span>.</p>
+<p>
+ To generate a changelog from your status.xml file you need to
+ request <span class="codefrag">/changes.html</span> or <span class="codefrag">changes.pdf</span> or
+ whatever format you have enabled within Forrest using output
+ plugins.
+ </p>
+
+
+<p>
+ Note that the projectInfo plugin provides a special RSS output
+ format of. Technically, this should not be part of an input plugin
+ and therefore it may be moved at a later date. However, you will
+ always be able to generate the RSS feed by requesting
+ <span class="codefrag">changes.rss</span>.
+ </p>
+
+
+<p>
+ You can generate a change log for a specific version by specifying a
+ version number in the request, for example,
+ <span class="codefrag">changes_0.1.html</span>.
+ </p>
+
</td><td>Your project is able to generate a changelog.</td><td>Implemented</td>
</tr>
@@ -393,14 +415,11 @@
</td>
</tr>
-
<tr>
<td>2. Create a developer list</td><td>
<br>
</td>
</tr>
-
-
<tr>
<td>3. Create a contexts list</td><td>
@@ -408,35 +427,30 @@
</td>
</tr>
-
<tr>
<td>4. Create a changes element</td><td>
<br>
</td>
</tr>
-
<tr>
<td>5. Create a release element</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>6. Create a notes element</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>7. Add actions taken during the development cycle</td><td>
<br>
</td>
</tr>
-
-
+
<tr>
<td>8. Generate the change log</td><td>
<br>