> The simpler alternative would be a wget of the docs on cocoon.apache.org.
>
> My argument would be that there's no bad thing keeping the new docs
> system for 2.2.
>
> Helma, are there any glaring mistakes in the currently live docs?
The updates that have been put into the xdocs/Daisy are not in the live
docs and the FAQ is empty.
Also, some javadoc extraction process has resulted in a few duplicates
of sitemap components where one of them points to minor information and
the other results in a 404.
I've already added FAQ to Daisy, so going the Daisy book route and
getting the PDF and/or HTML will in any case result in all the
documentation you would expect from the navigation bar on the site.
OTOH: a few pages that I could not find in the obvious place in the xdoc
directory of the repository are included as a link in Daisy.
These pages are:
under section "Status"
- changes
- todo
most of section "Community" and "Project" and "Links". Most of these are
external links anyway and are thus repeated.
So my take on this would be: include the Daisy book PDF and/or HTML and
make sure that the few pages that are not included (i.e. those described
above), are still available on the web, and updated if necessary.
As a user I'd rather see updated documentation that is completely
different from the previous release than the current crippled version
that has the familiar look.
Bye, Helma
|