David, As well as Frank's objections to rewriting, why does having one massive file necessarily improve the structure or maintainability. This is not the case with programming code. Docbook can include files in a far more structured manner than the gnucash xml sources do at the moment. I would have thought more modularization of the documentaion and some restructuring would improve the maintainability.
I think there is perhaps more need for the tutorial approach - "How to do this with Gnucash", particularly for newer users ,than for interface button by button functional type documentation and the latter is more useful when users have gained some experience and just want specific information on what happens when they select a particular button or menu option. My not particularly deep understanding of docbook is the more the documentation is broken down with separate headings the more searchable it becomes and the more easily specific information can be located by using a search. The tutorial sections tend to be more narrative/recipe like in their construction but by crossreferencing into a functional interface description a user can access the information when they need it and bypass it if it is not clear what is meant. David Cousens ----- David Cousens -- Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html _______________________________________________ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
