Just had a conversation with Mark over documentation, or
rather, the lack of documentation in our industry.

I thought companies didn't document their products (say, a hardware device
for a computer) for one of two lame reasons:

“It'll give our competition an insight into how we did things and
therefore they'll steal our R&D from underneath us.”

Their hardware is so crappy they don't want anyone to know just how bad
it really is.

But the primary reason, so according to Mark, is that the companies are
afraid of releasing the documentation because most of it is incomplete,
inaccurate or just doesn't exist to begin with.

And forget trying to get documentation from programmers or
engineers—they'll either quit and go elsewhere (where they don't have to
document) or what they write will be so horrible that no one actually uses
it (which is pretty much status quo from what I understand).

Or, even if the company can release the documentation, it does no good
because chances are good that they used products from other companies that
don't document what they did, or don't release documentation, or don't
release documentation without a thick layer of NDAs to CYA.

So the next time you get that chip from Intel for your next hardware
project? Just toss the documentation—it's totally bogus anyway.

Obligatory Miscellaneous

You have my permission to link freely to any entry here. Go
ahead, I won't bite. I promise.

The dates are the permanent links to that day's entries (or
entry, if there is only one entry). The titles are the permanent
links to that entry only. The format for the links are
simple: Start with the base link for this site: http://boston.conman.org/, then add the date you are
interested in, say 2000/08/01,
so that would make the final URL:

You may also note subtle shading of the links and that's
intentional: the “closer” the link is (relative to the
page) the “brighter” it appears. It's an experiment in
using color shading to denote the distance a link is from here. If
you don't notice it, don't worry; it's not all that
important.

It is assumed that every brand name, slogan, corporate name,
symbol, design element, et cetera mentioned in these pages is a
protected and/or trademarked entity, the sole property of its
owner(s), and acknowledgement of this status is implied.