Re: Writing free documentation/GNOME books

[William R Pentney <pentney cse Buffalo EDU>]

On 26 May 1999, Preben Randhol wrote:
I have to agree. I have managed to squeak out some work in GTK+ using the
scant documentation available. But developers' documentation for GNOME is,
I'm sorry to say, pretty poor right now. Available source is _not_ a
substitute for good documentation. Documentation can better explain the
purpose of certain calls, and the principles behind them.

- Bill

> True but I feel that the GTK reference manual is getting there. The
> GNOME one can do with some work :-) But of course reference manuals
> are the first step.
>  
> | We have to remember that there is a large amount of developers who
> | just don't read the source, they read the reference.
> 
> Well I do the opposite I read the source because I only have the
> reference. Many times it is not clear at all how to use a set of
> functions together. This is where the documentation (call it tutorial)
> comes in. It explains the philosophy of the library...
> 
> -- 
> Preben Randhol                              iEmacs is the best editor<ESC>
> [randhol@pvv.org] 	                    0cwVI(m)<ESC>
> [http://www.pvv.org/~randhol/]                               -- vim editor
> 
> 
> -- 
>         FAQ: Frequently-Asked Questions at http://www.gnome.org/gnomefaq
>          To unsubscribe: mail gnome-list-request@gnome.org with 
>                        "unsubscribe" as the Subject.
> 
>