Arthur Buijs wrote:
Jim Harris schreef:
[...]
But is the wiki the right way to go? How often will different versions
of the different manuals be published for download. How will formatting
work be done? The wiki involvs excellent tools for discussion and a
really simplistic way of editing, but the content is actually too big
for the system to handle. Versions tracking would be problematic, and
references to different parts would, mean a lot of extra work between
formats as this is not supported in the wiki?
Yes, I really think wiki is the way to go. They are very usable
(readable) online.
Every chapter or (big chapters) every sub-chapter has its own page and
thus its own buttons to download the documentation als pdf (or as odf).
Most of the time people only want to read online or print just that one
part of the documentation and not a complete book.
Ofcourse once in a while the complete book should be put together
(nightly build ...) from the most recent state of the wiki-pages.
I've never seen it so far but it doesn't sound impossible ... right?
Have a look at what I have done so far with the Getting Started
guide on the wiki. I just converted the ODT files, cleaned them
up, and inserted the graphics. The result can certainly be
improved upon (in several ways), but I think it shows some
possibilities.
http://wiki.services.openoffice.org/wiki/Getting_Started
I have not looked into buttons for downloading or printing, or
ways to compile chapters or whole books from wiki material. Those
are technical issues, and I'm assuming that solutions can be
retrofitted onto the pages when the time comes. I didn't want to
wait for the technical issues to be sorted out before making the
user guide information available in some online-accessible form.
--Jean
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
