On 2010-Oct-30 20:07:53 +1100, Minh Nguyen <nguyenmi...@gmail.com> wrote: >Let me explain why I agreed to be a technical reviewer of the proposed >book on Sage. Unless the Sage project has a dedicated documentation >team, or people in the Sage community decide to increase their >documentation output, we won't see any significant improvement in the >near future on the current state of documentation on Sage. Software >developers need to move beyond the mantra, "The documentation is in >the source code" and learn to be professional communicators, not just >professional programmers. A person may be a brilliant programmer, but >without sound communication skills (including writing skills) it can >prove very difficult for other people to understand and maintain their >code.
I completely agree with Minh here. Maybe some of the academics here could try and drum up some interest within their English, Journalism or similar faculties - somewhere there must be some students who are budding documentation writers looking for a project. And I also agree that a professionally produced book is much easier to read than a PDF or website. -- Peter Jeremy
pgpcNsK5YS8mN.pgp
Description: PGP signature
