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
