Hi Grzegorz, as requested, seeing the little problems with the documentation are still there after the latest changes, here is a small list of locations and changes that could be made.
1) On page http://cocoon.apache.org/2.2/1291_1_1.html The 'Note' at the bottom currently reads 'Beside transformation services there are also generation and a serialization services.' This would read better as 'Besides transformation services there are also generation and serialization services.' 2) On page http://cocoon.apache.org/2.2/1362_1_1.html Under the heading 'Using a block within the web application', the pom.xml update (dependencies block) lists the version as '1.0-SNAPSHOT'. The version should be '1.0.0' as listed further up the page '... Define value for version: 1.0-SNAPSHOT: : 1.0.0'. Under the heading 'Creating a parent pom' on the same page, the line that reads '... Maven also takes care that the modules are build...' should read '... Maven also takes care that the modules are built...' As a final suggestion, I wonder whether it would be useful to explain how to ensure maven uses the most up to date archetype plugin, to ensure 'archetype:generate' is available to the user? Perhaps that is beyond the scope of the document. Hope this helps, regards, Ross Grzegorz Kossakowski-2 wrote: > > Hi, > > I just wanted to let you know that documentation publishing (and > contributions publishing) has not > been forgotten but it faced some serious issues. > > I've implemented support for Flash files for our documentation > infrastructure (Daisy export plug-in) > but these changes seem to confuse Maven greatly. Documentation publishing > is mostly a manual process > now which is a very tedious thing as you can probably imagine. > > Therefore I decided to publish some things that I could recall that have > been modified and focus on > fixing the issues we have. > > New docs should appear within an our or two on main site, if you find > anything unpublished that you > would like to see on our site (e.g. your own changes) just give me an > addresses to the pages and > I'll take care of publishing by doing it manually. > > > Thanks to all for the patience and work on Cocoon's documentation. > > > -- > Best regards, > Grzegorz Kossakowski > > -- View this message in context: http://www.nabble.com/The-status-of-documentation-publishing-tp18484883p18504650.html Sent from the Cocoon - Dev mailing list archive at Nabble.com.
