Hartmut Figge wrote:

It would be nice, to have a compendium, yes. But someone has to write it
and the time of the devels is limited. There is a huge amount of bugs
which needs fixing.

I understand the limitations on developers' time, but I would make three points in favor of good documentation:

1) Good documentation is a major selling point; it sets good software apart from bad software in many users' minds, including mine;

2) On any complicated project, especially one involving many people, good documentation and notes are essential to keeping track of what you're doing and coordinating/cooperating with others;

3) I've found that if I can't explain something clearly to someone else, it generally means that I myself don't understand it.

There are trade-offs, of course, and there's a point of diminishing returns, but by and large good documentation is a worthwhile investment in a better product and greater efficiency.

--
War doesn't determine who's right, just who's left.
--
Paul B. Gallagher
_______________________________________________
support-seamonkey mailing list
[email protected]
https://lists.mozilla.org/listinfo/support-seamonkey

Reply via email to