[Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Branko Collin
I am getting a little confused by some of the statements made in this and earlier threads. What it comes down to, I guess, is that Daniel and Mel had a clear vision of the style of the new user documentation, but I somehow missed an explanation of that vision. In an earlier thread, Daniel

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Daniel Egger
Am Die, 2003-08-19 um 12.19 schrieb Branko Collin: What it comes down to, I guess, is that Daniel and Mel had a clear vision of the style of the new user documentation, but I somehow missed an explanation of that vision. We started the project by sketching that vision in some files in the

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Branko Collin
Thank you for your elaborate answer. I do have some follow-up questions though. On 19 Aug 2003, at 14:01, Daniel Egger wrote: Am Die, 2003-08-19 um 12.19 schrieb Branko Collin: [current manual] Why are you not too happy about the content and the structure? It is too anarchic in its

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Raphaël Quinet
On 19 Aug 2003 14:01:12 +0200, Daniel Egger [EMAIL PROTECTED] wrote: Am Die, 2003-08-19 um 12.19 schrieb Branko Collin: In an earlier thread, Daniel wrote: we're not too happy with the content and the structure of the GUMP. I take it you meant the GIMP documentation? GUM is the GIMP

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Daniel Egger
Am Die, 2003-08-19 um 14.25 schrieb Branko Collin: Thank you for your elaborate answer. I do have some follow-up questions though. No problem, whatever you want to know. :) Assume for a second that I know nothing about 'modern manuals'. What is it about them that you like. What did Mel

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Daniel Egger
Am Die, 2003-08-19 um 15.08 schrieb Raphaël Quinet: Now I am confused. I thought that we were talking about the online help system, not about the manual (GUM). It looks like you consider both of them to be the same thing. Is that right? The old gimp-help was build upon the content of the

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread pcg
On Tue, Aug 19, 2003 at 07:32:24PM +0200, Daniel Egger [EMAIL PROTECTED] wrote: book, see below) was anachronistic, more like a reference than a fluent style, every single part following the exactly same style like a manpage. We changed quite a lot and tried to enrich the content as much

Re: [Gimp-developer] style guide gimp-help-2

2003-08-19 Thread Daniel Egger
Am Mit, 2003-08-20 um 01.41 schrieb [EMAIL PROTECTED]: References are extremely important, more important than tutorials in prose, IMnsHO. This doesn't clash with my idea. Especially good cross references are important but this is exactly one of DocBooks' strengths. Now, maybe this can be