Date: Sat, 3 Jul 1999 07:43:59 +0200 From: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl> To: Jesus Monroy <jesus.monroy@usa.net> Cc: Alfred Perlstein <bright@rush.net>, advocacy@FreeBSD.ORG Subject: On programmers and documentation Message-ID: <19990703074359.B61399@daemon.ninth-circle.org> In-Reply-To: <19990701011234.25026.qmail@www0x.netaddress.usa.net>; from Jesus Monroy on Wed, Jun 30, 1999 at 06:12:33PM -0700 References: <19990701011234.25026.qmail@www0x.netaddress.usa.net>
next in thread | previous in thread | raw e-mail | index | archive | help
* Jesus Monroy (jesus.monroy@usa.net) [990701 06:47]: > > Let's ask a real question: > Why can't program fixers write the fricken man > page fix also? > What's up with that? I'd rather have DES, EE, Alfred, Brian, David, Mike, Kirk, Matt, Wes, Peter, Doug, etc, etc. write initial documentation and leave it for some others to change them to better documentation. This alows them to work on resolving bugs. > Is this the correct response: > Okay, I'll take the glory, but we have janitors > to clean up after we are done. We call them > document specialist(sp?). So I may start to call myself a document specialist now eh? Anyways Jesus, it takes time to work on these things, I invest time in trying to get the documentation correct. Sheldon is doing a great job on the GNATS database (plus the occasional help from me and some others), Doug is doing great things for the -questions stuff so that -current gets addressed on certain issues. Chris Piazza has been very active on -ports. Nik has done wonders for -doc. (And now I am forgetting hordes of other people.) I have yet to see your name appear out of the blue. Instead of writing mails that merely accuse (which I take personal because I invested time in it) I would ask you to put forth another 5-10 minutes on the mail/subject and look at WHAT needs to be fixed and HOW plus, if available, with diff-/patchfile. If you just criticise without giving proper feedback/help yer not really making friends. Everyone can miss `parasites' for lack of a better term. [parasites as in feeding on the precious time of others which could have been used to fix the little manpage problems present which started this whole fscking thread] [NOTE: first posting about this subject, I will only reply to sensible answers] With regards, -- Jeroen Ruigrok van der Werven asmodai(at)wxs.nl The BSD Programmer's Documentation Project <http://home.wxs.nl/~asmodai>; Network/Security Specialist BSD: Technical excellence at it's best Cum angelis et pueris, fideles inveniamur. Quis est iste Rex gloriae...? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-advocacy" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990703074359.B61399>