My idea in creating documentation is that the student or perhaps a small group of student would work with developers who would make sure that the new information was accurate. Also - as part of the project the sudents would find end users - maybe a Linux users group and give them the docs and software and watch them learn and configure Mailman from the documentation and record their voice comments so as to learn what is confusing about the documentation.
After completing the course - the fact that they did this software documentation project becomes part of their job resume and might create an ongoing relationship between the student and the developers. And free software would greatly benefit.
Barry A. Warsaw wrote:
MP> One problem with developers writing their own documentation is"MP" == Marc Perkel <[EMAIL PROTECTED]> writes:
MP> that the developer never experienced learning the program. One
MP> of the problems with almost all free software is that the
MP> documentation could be a lot better.
True!
MP> There are also many schools out there that have courses for
MP> people who want to become technical writers. People who's job
MP> it will someday be to do software documentation. So it occurs
MP> to me that if technical writing colleges hooked up with free
MP> software projects and assigned documenting free software -
MP> such as Mailnan to students - that it would be beneficial for
MP> both worlds.
Wow, Marc, that's an excellent idea. Do you have any contacts and/or
could you facilitate this?
-Barry
_______________________________________________
Mailman-Developers mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/mailman-developers
_______________________________________________ Mailman-Developers mailing list [EMAIL PROTECTED] http://mail.python.org/mailman/listinfo/mailman-developers
