From owner-freebsd-questions Fri Mar 16 19:56:49 2001 Delivered-To: freebsd-questions@freebsd.org Received: from mail.freebsd-corp-net-guide.com (mail.freebsd-corp-net-guide.com [206.29.169.15]) by hub.freebsd.org (Postfix) with ESMTP id 095E437B71A for ; Fri, 16 Mar 2001 19:56:46 -0800 (PST) (envelope-from tedm@toybox.placo.com) Received: from tedm.placo.com (nat-rtr.freebsd-corp-net-guide.com [206.29.168.154]) by mail.freebsd-corp-net-guide.com (8.11.1/8.11.1) with SMTP id f2H3ucx11278; Fri, 16 Mar 2001 19:56:39 -0800 (PST) (envelope-from tedm@toybox.placo.com) From: "Ted Mittelstaedt" To: "David Johnson" Cc: Subject: RE: documentation issues generally Date: Fri, 16 Mar 2001 19:56:38 -0800 Message-ID: <000401c0ae96$44c0fe40$1401a8c0@tedm.placo.com> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook 8.5, Build 4.71.2173.0 In-Reply-To: <3AB25AA3.CFD6AC22@acuson.com> X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3155.0 Importance: Normal Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG >-----Original Message----- >From: David Johnson [mailto:djohnson@acuson.com] > >It's not that they consider it "wasting time", it's just that it's pure >drudgery. I've written documentation for my own programs, and am >currently helping with docs for KDE. It's not fun. It's boring. The >developers should be the ones writing the docs, since they know the >software the best, but they will probably be the ones least likely to Ah, but there's more to writing docs than just knowing the material. The other part is getting that material across. Docs written by someone who only knows the material best but is unable to effectively get the point across are just as bad as docs written by someone who may be able to communicate but doesen't know the material. If the developer can't communicate effectively, they shouldn't be the ones documenting the software. Ted Mittelstaedt tedm@toybox.placo.com Author of: The FreeBSD Corporate Networker's Guide Book website: http://www.freebsd-corp-net-guide.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message