Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 12 Mar 2000 16:42:49 -0500 (EST)
From:      Chuck Robey <chuckr@picnic.mat.net>
To:        Nate Williams <nate@yogotech.com>
Cc:        Dennis <dennis@etinc.com>, Jeroen Ruigrok/Asmodai <asmodai@wxs.nl>, Joe Abley <jabley@patho.gen.nz>, hackers@FreeBSD.ORG
Subject:   Re: Is FreeBSD dead? Well, not in theory...
Message-ID:  <Pine.BSF.4.21.0003121639400.32633-100000@picnic.mat.net>
In-Reply-To: <200003122133.OAA09182@nomad.yogotech.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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.

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.

----------------------------------------------------------------------------
Chuck Robey            | Interests include C & Java programming, FreeBSD,
chuckr@picnic.mat.net  | electronics, communications, and signal processing.

New Year's Resolution:  I will not sphroxify gullible people into looking up
fictitious words in the dictionary.
----------------------------------------------------------------------------



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-hackers" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.21.0003121639400.32633-100000>