Re: [GNC-dev] Help documentation

2021-02-23 Thread Geert Janssens
A complex topic is brought up here. I agree with the issues you bring up. I don't know if or how we can solve them all. In the gnucash project we currently only have experience with docbook for user oriented documentation and doxygen for our api documentation. On the premise what we have so

Re: [GNC-dev] Help documentation (gtkbuilder part)

2021-02-17 Thread Frank H. Ellenberger
Am 17.02.21 um 05:15 schrieb John Ralls: > > >> On Feb 16, 2021, at 4:16 PM, Frank H. Ellenberger >> wrote: >> >> Most of the static part of the GUI is in the glade files, which are XML. >> It should not be very hard to XSLT the nodes for the structure, and >> finally labels and tooltips. >

Re: [GNC-dev] Help documentation

2021-02-16 Thread John Ralls
> On Feb 16, 2021, at 4:16 PM, Frank H. Ellenberger > wrote: > > Most of the static part of the GUI is in the glade files, which are XML. > It should not be very hard to XSLT the nodes for the structure, and > finally labels and tooltips. Dunno about most. There's a surprising amount of

Re: [GNC-dev] Help documentation

2021-02-16 Thread Frank H. Ellenberger
Am 16.02.21 um 18:21 schrieb John Ralls: > The way we manage program help has four serious problems: > > 1. It's separate from the program--not even in the same git repository--so > changes to the program are seldom reflected in the help. Very little of it > has been touched in the last 10

[GNC-dev] Help documentation

2021-02-16 Thread John Ralls
The way we manage program help has four serious problems: 1. It's separate from the program--not even in the same git repository--so changes to the program are seldom reflected in the help. Very little of it has been touched in the last 10 years. 2. It's largely monolithic which makes it