There needs to be higher standards on documentation. I think it is too bad
there is not more documentation. I know that most developers don't enjoy
writing documentation, but we really need it. How many people here have had
trouble writing code and have been set back for days because something
wasn't documented correctly? It should be the first priority of the Mozilla
open source project to provide adequate documentation to developers. If more
quality docs were written, the following would occur:
1) Mozilla would get more developers - people would be more happy to help if
they knew where to start. They wouldn't get discouraged and quit due to the
lack of documentation
2) Code would get written faster - people wouldn't be stumped for a long
time, trying to figure out someone else's code.
3) Other developers wouldn't be asked as many questions, and people would
know more before they asked the questions - People could actually say "Look
at the docs" without sentencing someone to their death.
On a side note, I think there could be a Mozilla documentation request
system that collects requests for documentation and sorts them by
module/subsystem/etc.
Is it possible we could freeze the tree after Mozilla 1.0 is released in
order for all the developers to document their modules and subsystems they
work on? (Possibly for a couple weeks?)
