>>>>> "RBAK" == Roger B A Klorese <rogerk@QueerNet.ORG> writes:
RBAK> ...which is why part of developing code is writing the man pages, at
RBAK> least in every software development shop I've ever worked.
Umm, yeah. And what he's doing is taking the documentation I've written
(of which there are rather copious amounts embedded in POD form within the
code, along with the user references I've written) and making it readable
by the people who use the commands. I'm not good at documentation. I
realize that. Even the reference stuff needs to be rewritten before it is
really useful to end users; I'm just too close to the code and understand
too many of the issues. (Plus I understand things like regexps that even
your average site owner isn't going to have quite as firm a grasp on.)
Surely you can't be seriously advocating that nobody should ever adjust the
documentation that the programmers write? Programmers tend to be some of
the worst documenters, beaten only by those VCR manual translators.
- J<
Follow-Ups:
References:
|
|
