Re: [gtk-list] Re: Documentation

[Guillaume Laurent <glaurent worldnet fr>]

Valdis.Kletnieks@vt.edu writes:

> On Thu, 20 Jan 2000 11:11:50 +0100, Guillaume Laurent <glaurent@worldnet.fr>  said:
> > The only way documentation is going to get written is if people who
> > wrote the code document it, or at the very least clearly explain it to 
> > a technical writer.
> 
> A very good point.  Writing good usable documentation is a skill.
> Not everybody has this skill nor the training to do it well.

Agreed, but I was also thinking of all these pesky details like "who
owns this returned pointer", "is this const or not", etc... which
don't need any special skills to be clearly written down.

-- 
						Guillaume