Douglas,

The programmer did write documentation! That's what we currently have. Often it is a good idea for a non-programmer (ie. user) to write the documentation from their point of view.

Anyway, this is open software and the more people that help develop it (and it's documentation) the better. If you don't write it I'm sure somebody will someday :-)

-g

On 6/5/06, Douglas Garstang dgarstang@oneeighty.com wrote:

...

-----Original Message----- From: Juha Heinanen [mailto:jh@tutpro.com] Sent: Sunday, June 04, 2006 11:01 AM To: Douglas Garstang Cc: Bogdan-Andrei Iancu; Sam Lee; users@openser.org Subject: RE: [Users] Avpops tutorial

Douglas Garstang writes:

...

I'm not one of the developers.

you don't need to be. in fact, it would give developers' more time to develop, i.e., write code.

How can I write the documentation when I don't understand how the software works? Are you suggesting I learn C and look at the code?

I'm of the opinion that developers should write documentation. If other people try to do it, they make bad assumptions based on what they THINK they know. They then write bad or wrong documentation which others read, and in turn also write bad documentation. It's not a good model.

Doug

---

Users mailing list Users@openser.org http://openser.org/cgi-bin/mailman/listinfo/users