+0 for ODF/OpenOffice
I'm fine with either option at this point. I slightly prefer ODF and
editing with OpenOffice than the wiki, but I would prefer straight HTML
or a text-based format to ODF.
My recent complaints about maintaining the installation guide on the
wiki applied only to one very specific aspect, the inline inclusion of
the context XML files, in which maintenance of XML entities
(particularly &) is intolerably hard. I proposed only to drop these
and go exclusively with the downloaded XML file attachments.
Image attachment maintenance on the wiki, combined with the awkward
versioning by renaming/copying scheme has been another peeve; it doesn't
work, and these links are always breaking, and one seems to need local
filesystem access on the wiki host to fix this, which most of us don't have.
I'm fine using Open Office and seeing how that goes for awhile; I
suspect we'll like it and the end-result will be nicer than the wiki.
However, a little more needs to be thought out for the ODF option.
(1) If there is anything specific (e.g. option settings, etc) we need to
be doing when generating the text, HTML, and PDF versions, that itself
needs to be documented.
(2) Also, we would need a mechanism for publishing/republishing the HTML
version to the Web, either on an Incubator site, or on
rollerweblogger.org. All of the contributors should be able to do this
without assistance from Dave.
--a.
David M Johnson wrote:
I'm trying to get another 2.1 release candidate ready, so I'd like to
resolve this issue.
I'm not sure we had enough folks weigh in to get consensus on this, so
I'd like
to call a vote to decide on one of these two options:
Pick one:
[ ] Option #1: For Roller 2.1 keep installation guide on wiki as we
always have
[ ] Option #2: For Roller 2.1 instead use Open Document Format
(ODF) as source format for installation guide as described below
Plan for using ODF as source format for installation guide in 2.1:
* Use Dave's new ODF version of the installation guide
* Include in release: text, HTML, PDF and ODF versions of the install
guide
* Make same formats available on the Roller web site
* Maintain the 2.1 release notes on the wiki, so we can easily update
them
See also: ODF and PDF versions of Roller 2.1 user and install guides
http://people.apache.org/~snoopdave/doc_drafts/
- Dave
On Jan 25, 2006, at 12:21 AM, David M Johnson wrote:
We have up-to-date versions of the user guide and installation guides
for
Roller 2.1-incubating in ODF format now. We already decided to use ODF
for the user guide.
Should we have a vote on whether or not to use the ODF install guide
in the 2.1 release? If not, I'll put it back on the wiki.
I argue that:
Using ODF in 2.1 does not preclude changing to a different source
format
in the future (thanks to well-known, standard XML format and the OO
Java API).
And I think they are an improvement over the JSPWiki versions, so I
propose we:
* Ship the ODF and PDF files in the release
* Make ODF, PDF and HTML versions available on the web
* Put the release notes on the wiki, so we can easily update them
