-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Brad O'Hearne wrote: > You are talking about the difference between an author and an editor to > some degree. A developer has to document, and that includes being able > to impart in some form user level documentation if it pertains to what > they worked on, even if someone else reshapes that into something > prettier for general consumption. If the developer is unable to > effectively communicate their contribution, then that is not an issue > which should alter the project approach; it is an issue which should > alter whether that developer contributes or not. I find it personally > hilarious that we place as a prerequiste for a developer fluency in the > language of Java or C++ and completely discard fluency in the language > of English. Communication isn't some kind of optional "nice to have"; > its a necessity. > > Brad
Agreed. My main point isn't that a developer can't document. Just that developer documentation is rarely suitable for a project's user documentation and the more intermediaries there are, the slower that documentation is 'complete'. [ever had that feeling some threads could go on forever? ;-)] As for documentation and Jira... I said I was over there, and this relates back to "but...": MNG-1373 (http://jira.codehaus.org/browse/MNG-1373) This is the type of thing that makes "contribute if you don't like it" daunting. Issue raised back in October. Relates to MNG-1686 (http://jira.codehaus.org/browse/MNG-1686) from November. Both are "Open". Both are "Major". Both unassigned and with patches. I've actually been trying to marry the issue with the site and found an issue (with regard to documentation source) with simply checking out Maven. ($ svn checkout http://svn.apache.org/repos/asf/maven/components/trunk/ maven-site - but maven-site isn't there). So a) this issue is still truly unresolved because the patch hasn't been reviewed/applied, or b) the issue has been resolved because the patch has been reviewed/applied, but Jira hasn't been updated to reflect that. As a "user" who wants to "contribute"...? -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (MingW32) iD8DBQFEDRCkaCoPKRow/gARAh8EAKCkL+LiPQLAEgt/0xuMviFkQjp48QCgqr7N j6JSltjUn4ICl+s4Ycjtdr8= =tfdU -----END PGP SIGNATURE----- --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
