GnuCash Concept Guide

[Bengt Thuree]

On Ti, 2006-04-11, 13:41, Chris Lyttle skrev:
> 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.

That was the general idea. And we did float the idea on the various lists
for a while before implementing them.
Do not seem to work though, since the only person who has modified the
wiki is myself. If this continues then we might as well just write it in
docbook directly.

Correction: Beth has made additions to the Overview which is highly
appreciated :) Thanks

> 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.

That was also the general idea. Not to take everything from the wiki at
face value but at best face value, and at worst an inspiration idea. The
content has to flow naturally, with one voice from one chapter to another,
so to speak.

> 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.

My idea was to actually remove the concept guide from the wiki, as soon as
we have reached a certain stage, so we only have one original. Only use
the wiki to get inspirational help, various examples, uncertain areas,
spell-checks and grammatical helps etc.

> 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.

Our intention has not been to step on any toes here, rather to try to
ensure that GnuCash gets an updated document ready for the 2.0 release. I
would be the first to admit that I am not a member of the documentation
team, nor the best knowledgable person as far as GnuCash goes.

/Bengt