Re: Milestones document

[Ali Abdin <ALIABDIN aucegypt edu>]

I think its a bit 'difficult' to write documentation - There is no 
DOCUMENTED way of writing API documentation - Although there is 
documentation for writing whitepapers.

Also - I think people who want to contribute (well, me at least) - get 
discouraged because I have to learn DocBook (all I know is that I 
installed these RPMS for documentation). Also, I heard that people author 
DocBook stuff using emacs in PSGML mode. A) I use vi B) What the hell is 
PSGML mode? C) see my reference for documentation on writing API 
documentation (i.e. what are the procedures one should take?)

On Mon, 6 Dec 1999, Havoc Pennington wrote:

> 
> On Mon, 6 Dec 1999, Derek Simkowiak wrote:
> > there are far too many undocumented widgets.  If it were up to me, every
> > widget/API would have complete descriptions, a list of pitfalls and
> > common problems, along with an illustrative example.
> > 
> 
> Fortunately, it _is_ up to you - anyone can contribute! We are way
> understaffed here. 
> 
> Havoc
> 
> 
> 
> -- 
> To unsubscribe: mail gnome-devel-list-request@gnome.org with "unsubscribe"
> as the Subject.
> 
>