Hi Nino,
General question: since it's a wiki, doesn't it make more sense to
have the docs in wiki format rather than ODT?Which do you personally prefer?
I don't have a preference, except that it's probably technically
easier to write in ODT and then be able to export to the wiki, PDF and
any other formats the project chooses to publish in. I guess that in
the absence of any recommendations from a documentation project lead,
I'd just watch contributors' habits and see from there.
Historcally, the question has been raised a couple of years ago in the
ooo project. The answer was to use the format in which most people
preferred to contribute (which seems pretty rational). Both
possibilities were offered, but AFAIK the community has preferred ODT
for writing User Guides by far, whereas Dev Documentation has been
mainly produced in wiki form.I don't think that a formal decision has been made. Up to now, there is
no official (or inofficial) team in charge of the doc project. So who
should make a decision? Things are just evolving
Jean Hollis Weber seems to be active in documentation, and seems to
have been an old-timer in the OOo project (if I'm not mistaken)...
Maybe he's the kind-of de facto lead for the moment?
But anyways - I think it would be a good decision to take ODT as master
format for User Guides and Wiki as master for Developer documents.
Conversion ODT -> Wiki and vice versa is possible but time consuming,
so keeping both formats in sync does not seem a good option unless we
have enough people taking the task.With using drupal as CMS there could be a third option: to produce
drupal master documents which then could be offered in web form and
then transformed to ODT/PDF, but this possibility has to be implemented
and tested still. This will take some months, I think.Nevertheless, for quick drafting, the wiki can always be used without
problems.
OK, thanks, that gives one an idea.
I plan to work through the posted material and do some proofreading.
Fine.
OK, then I'll continue from where I started then. Thanks for the pointers.
David Nelson