Re:It’s Time We Stopped Rewarding Projects with Crappy Docum...
by ubernostrum on Wednesday August 05, 2009 @01:35PM
(#743844)
Well, you can also encourage contributors to document their work. With Django, for example, our policy is that a submitted patch will not be committed unless it includes both unit tests and documentation in addition to the code.
This means it can take longer for a patch to be accepted, but it also means that the documentation stays up-to-date.
Re:It’s Time We Stopped Rewarding Projects with Crappy Docum...
by dasil003 on Thursday August 06, 2009 @02:01PM
(#746023)
Absolutely. I think this is the real answer. Developers need to learn to document and improve their UI skills. To me those are core skills of a developer. We can't expect professionals in those areas to come in and rescue open source.
Open source developers are scratching an itch. What itch would a UI or documentation person be scratching? The project would only be relevant if it's a user-facing app that they themselves use.