From owner-freebsd-hackers Sun Mar 12 21:20: 6 2000 Delivered-To: freebsd-hackers@freebsd.org Received: from obie.softweyr.com (obie.softweyr.com [204.68.178.33]) by hub.freebsd.org (Postfix) with ESMTP id 1322037B5E2 for ; Sun, 12 Mar 2000 21:20:00 -0800 (PST) (envelope-from wes@softweyr.com) Received: from softweyr.com (wes@homer.softweyr.com [204.68.178.39]) by obie.softweyr.com (8.8.8/8.8.8) with ESMTP id WAA04281; Sun, 12 Mar 2000 22:18:33 -0700 (MST) (envelope-from wes@softweyr.com) Message-ID: <38CC7A48.B948C670@softweyr.com> Date: Sun, 12 Mar 2000 22:19:04 -0700 From: Wes Peters Organization: Softweyr LLC X-Mailer: Mozilla 4.7 [en] (X11; U; FreeBSD 3.3-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: Chuck Robey Cc: Nate Williams , Dennis , Jeroen Ruigrok/Asmodai , Joe Abley , hackers@FreeBSD.ORG Subject: Re: Is FreeBSD dead? Well, not in theory... References: Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Chuck Robey wrote: > > On Sun, 12 Mar 2000, Nate Williams wrote: > > > > >That's also why I am wasting my time slowly documenting the FreeBSD > > > >internals in my spare time. > > > > > > "slowly" is the key word here. Real products are documented before they are > > > in commercial use. > > > > Really? That's very different from my experience as a commercial > > software developer. > > > > And, it's not the experience I had from using your products as well. > > Documentation was as sparse as the FreeBSD documentation, but this is > > typical of most projects, except for government projects which requires > > truckloads of documentation. > > > > That's the main reason that government projects are rarely on time and > > budget, and never end up with the features that are desired. They spend > > all their time documenting, and no time implementing. :) > > You ever see those docs they write? Generally, it's an odd case of > nothing actually being better than something. Hey! Some of my past work resembles that remark! > I did once see a company that did the docs first, and then used those docs > as the design template. Any changes in the design had to be modified in > the docs first, and the docs were under a version control system. > > That was the one and only time I ever saw that. Dennis is living on > another planet than we do. And don't call the stuff that comes with > consumer products docs, because they are usually written by marketing, and > usually largely a work of fiction. I actually work for a company that writes both software and hardware design specs before plunging off into development work. Of course, the specs are never updated after the fact, so they're completely worthless for any follow-on work. In effect, the C, asm, and VHDL becomes the as-built documentation, which is quite horrid. -- "Where am I, and what am I doing in this handbasket?" Wes Peters Softweyr LLC wes@softweyr.com http://softweyr.com/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message