cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From da...@cocoon.zones.apache.org
Subject [DAISY] Created: ToDo list
Date Wed, 28 Mar 2007 21:56:35 GMT
A new document has been created.

http://cocoon.zones.apache.org/daisy/documentation/1346.html

Document ID: 1346
Branch: main
Language: default
Name: ToDo list
Document Type: Cocoon Document
Created: 3/28/07 9:56:25 PM
Creator (owner): Reinhard Pötz
State: publish

Parts
=====

Content
-------
Mime type: text/xml
Size: 5967 bytes
Content:
<html>
<body>

<p>This is a todo list full of tasks that need to be done to get the new 2.2
docs published:</p>

<h1>1. Minimal</h1>

<table>
<tbody>
<tr>
<th>
<p>Description</p>
</th>
<th>
<p>Who</p>
</th>
<th>
<p>Notes</p>
</th>
<th>
<p>Status</p>
</th>
</tr>
<tr>
<td>
<p>Get the Daisy Maven plugin properly released</p>
</td>
<td>
<p>RP</p>
</td>
<td>
<p>I've got in contact with Bruno and he gave me green light for cutting an
alpha release of it.</p>
</td>
<td>
<p>in progress</p>
</td>
</tr>
<tr>
<td>
<p>Create a special 2.2 site</p>
</td>
<td>
<p>RP</p>
</td>
<td>
<p>Create a Daisy site containing general information about Cocoon 2.2. It will
consist of only a handful pages as most of the information should go into the
blocks or core modules where it belongs to.</p>
</td>
<td>
<p>open</p>
</td>
</tr>
<tr>
<td>
<p>Finish <a href="daisy:1285">PMC site</a></p>
</td>
<td/>
<td>
<p>The PMC site has still some blank pages and sections.</p>
</td>
<td>
<p>open</p>
</td>
</tr>
<tr>
<td>
<p>Complete pom.xml</p>
</td>
<td/>
<td>
<p>Make sure that cocoon/trunk/pom.xml contains the complete list of current and
previous Cocoon committers and PMC members</p>
</td>
<td>
<p>open</p>
</td>
</tr>
<tr>
<td><a href="daisy:1285">Review PMC</a>
<p>site and 2.2 site docs</p>
</td>
<td/>
<td>
<p>Both sites have to be proof-read by a native speaker before they can go
online.</p>
</td>
<td>
<p>open</p>
</td>
</tr>
</tbody>
</table>

<h1>2. Docs for released Cocoon modules</h1>

<table>
<tbody>
<tr>
<th>
<p>Description</p>
</th>
<th>
<p>Who</p>
</th>
<th>
<p>Notes</p>
</th>
<th>
<p>Status</p>
</th>
</tr>
<tr>
<td valign="top">
<p>Verify Daisy backup</p>
</td>
<td valign="top"/>
<td valign="top">
<p>At  last year's GT Bertrand worked on the backup. According to him it works
but, as request by himself, somebody else should confirm this.</p>
</td>
<td valign="top">
<p>open</p>
</td>
</tr>
<tr>
<td valign="top">
<p>Implement the <a href="http://people.apache.org/~hepabolu/final6.html">new
design</a> as Maven skin</p>
</td>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
</tr>
<tr>
<td valign="top">
<p>RSS feed</p>
</td>
<td valign="top">
<p>RP</p>
</td>
<td valign="top">
<p>Provide an RSS feed containing the <a href="daisy:1285">news</a> of the
front
page and add it to PlanetApache</p>
</td>
<td valign="top">
<p>open</p>
</td>
</tr>
<tr>
<td valign="top">
<p>Provide docs for all released modules and blocks</p>
</td>
<td valign="top">
<p>many</p>
</td>
<td valign="top">
<p>This task is split up into several sub tasks. See the table below</p>
</td>
<td valign="top">
<p>open</p>
</td>
</tr>
</tbody>
</table>

<p>This table is a matrix of rather small  sub tasks that are required to get
the documentation of a particular module (a block, a core module, a Maven
plugin) finsihed:</p>

<table>
<tbody>
<tr>
<th/>
<th>
<p>Daisy site</p>
</th>
<th>
<p>General site</p>
</th>
<th>
<p>"documentation" docs</p>
</th>
<th>
<p>Wiki docs</p>
</th>
<th>
<p>Sitemap components</p>
</th>
<th>
<p>changes.xml</p>
</th>
<th>
<p>proof-read</p>
</th>
<th>
<p>General notes</p>
</th>
</tr>
<tr>
<th>
<p>forms</p>
</th>
<td>
<p>done (RP)</p>
</td>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<th/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<th/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<th/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<th/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<th/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<th/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
<td/>
</tr>
</tbody>
</table>

<p>explanation of the colum titles:</p>

<table>
<tbody>
<tr>
<td><strong>Daisy site<br/>
</strong></td>
<td>
<p>Does the Daisy site, the root navigation document and an index document
exist?</p>
</td>
</tr>
<tr>
<td><strong>General site<br/>
</strong></td>
<td>
<p>Is the new site added to the general site (Cocoon book, administration docs
to get easier access to it)</p>
</td>
</tr>
<tr>
<td><strong>Move "documentation"<br/>
</strong></td>
<td>
<p>The Daisy site "documentation" already contains a lot of documents. If there
are relevent docs there for a specific module, it has to be  moved to it. Don't
forget to add it to the new module's collection and remove it from the
collection "document".</p>
</td>
</tr>
<tr>
<td><strong>Wiki docs<br/>
</strong></td>
<td>
<p>The wiki contains a lot of high-quality information that is worth of being
added to the official docs.</p>
</td>
</tr>
<tr>
<td valign="top"><strong>Sitemap components<br/>
</strong></td>
<td valign="top">
<p>Sitemap component that contains special qdoc Javadoc attributes, are imported
into the Daisy wiki. They are already added to the appropriate collection. The
only things that has to be done is adding a query to the module's root
navigation document and include it to the query of the "2.2-site" root
navigation document which contains a complete list of all sitemap components for
the user's convenience.</p>
</td>
</tr>
<tr>
<td valign="top"><strong>changes.xml<br/>
</strong></td>
<td valign="top">
<p>Does a changes.xml exist and is it up-to-date? Make sure that all releases
are listed with the correct release dates.</p>
</td>
</tr>
<tr>
<td valign="top"><strong>proof read<br/>
</strong></td>
<td valign="top">
<p>Some native-speaker should proof-read it</p>
</td>
</tr>
</tbody>
</table>

<h1>3. The rest</h1>

<p>There are more modules that deserve to be documented:</p>

<table>
<tbody>
<tr>
<th/>
<th>
<p>Daisy site</p>
</th>
<th>
<p>General site</p>
</th>
<th>
<p>"documentation" docs</p>
</th>
<th>
<p>Wiki docs</p>
</th>
<th>
<p>Sitemap components</p>
</th>
<th>
<p>changes.xml</p>
</th>
<th>
<p>proof-read</p>
</th>
<th>
<p>General notes</p>
</th>
</tr>
<tr>
<th/>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
<td valign="top"/>
</tr>
</tbody>
</table>

</body>
</html>

Collections
===========
The document belongs to the following collections: cdocs

Mime
View raw message