I think it is a good idea. First rule of anything documentation wise is
K.I.S - Keep it Simple.

There is always one option, that you have a system for transferring them
into wiki format using an extension that everyone working on the docs
downloads and uses, and thus publish all the docs in the various formats at
the same time. I thought we had an extension for this? But if ODT and PDF
are the priority, I reckon just go with that.

On 30 September 2010 09:17, Jean Hollis Weber <[email protected]> wrote:

> Note: I'm talking about *user* guides, not developer or sysadmin docs in
> this note.
>
> We discussed on several occasions whether to provide the user guides in
> wiki formatas well as in PDF and ODT. I'm in favour of using all 3
> methods as means of reaching different members of the audience, but...
>
> We don't have enough people updating the wiki to keep up with changes in
> the source docs, so some parts of the user guides on the wiki are
> getting more and more out of date. For whatever reasons, the work is not
> getting done.
>
> So... perhaps it's time to drop the wiki version of the user guides?
> Just put a marker on the pages that they are no longer being maintained
> and abandon them until/unless someone can take on the job and do it.
>
> We're having enough difficulty keeping the ODTs up to date, with not
> enough people doing that either. But they are the source from which to
> create PDFs and any other form we want to have the user docs provided
> in. Also, we or others can fairly easily customise those ODTs for other
> flavours of OO, and translators use them too.
>
> Comments?
>
> Jean
> --
> Jean Hollis Weber
> Co-Lead, OpenOffice.org Documentation Project
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [email protected]
> For additional commands, e-mail: [email protected]
>
>


-- 
Best wishes

Claire Wood

Reply via email to