As the maintainer of the GnuCash documentation let me make a statement
here. First, I have no problems with people editing the docs in a wiki
or whatever makes it easier to actually write content.
However, I would then put myself in an editorial role and decide what
would make it from there into the actual offline docs and add the
required docbook to make that happen. The docbook tags to me btw are the
easiest bit, I find it really difficult to get good quality content to add.
That being said, we could end up in a situation where the definitive
docs are what is distributed and any 'extra' help is online on the Wiki,
which isn't too unusual in OSS software but just to let you know how it
would go if you wanted to pursue editing docs on a Wiki. There would
never be a situation in my mind where the online version would replace
the offline docs as the primary and definitive version. This afaik in
the default situation for almost all gnome docs.
Having someone like Jon who could do both was a boon to me (he basically
did the concepts guide, where I did the main help) but its not necessary
to me to have the same person writing content as writing docbook tags.
Chris
Derek Atkins wrote:
David Grant <[EMAIL PROTECTED]> writes:
But why do you even need docbook in the first place? Why not just use
mediawiki?
Two words: "Printable Copy". We want to be able to have a source that
allows us to put it on the web OR turn it into a PDF for printing.
A mediawiki-only solution doesn't provide the latter.
I definitely recommend putting all the documentation in some form of
wiki or drupal form so that anyone can edit pages easily.
It's all in SVN. Anyone can edit the pages easily. It just requires
more priviledge to actually change the shared copy. ;)
David
-derek
_______________________________________________
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
