[TriLUG] Is it just me or...
gwbrown1 at gmail.com
Thu Apr 13 15:56:45 EDT 2006
That was a fairly good example of horribly written technical manuals.
Anything that uses $FOO and $BAR in examples fits that catagory too, in my
On 4/13/06, John Mitchell <john280z at gmail.com> wrote:
> Maybe he was paid by the word(more words = more money).
> johnm :)
> On 4/13/06, Rick DeNatale <rick.denatale at gmail.com> wrote:
> > .. is this not one of the worst written pieces of technobabble you've
> > I ran across this via the del.ico.us rss feed.
> > It wanders around trying to make some misbegotten points about
> > object-orientation, compilation, and such.
> > For example:
> > "Continuing with the model car example, when you built the engine, you
> > didn't use any of the parts that would later build the seats (a 350
> > four-barrel engine with a seat belt sticking out if the piston would
> > look pretty silly). The point is that all the parts that made up the
> > engine were of a certain class of parts. They all went together. Ditto
> > with the body and then the interior."
> > "The point is that in these languages, you build objects out of
> > classes of commands to create the whole. Understand the terminology?"
> > Classes of commands? All engines parts are of the same class?
> > Understand the terminology. Why yes I do, but the author doesn't.
> > Then it starts to wind up with:
> > " So to answer the question of which to use where... use whichever
> > fits your needs. That sounds like a cop-out answer,"
> > BECAUSE IT IS!
> > It kind of makes me want to establish a Bulwer-Lytton contest for
> > technical writing, if one doesn't already exist.
> > Sorry for ranting, but for some reason this one really set me off.
> > --
> > Rick DeNatale
> > Visit the Project Mercury Wiki Site
> > http://www.mercuryspacecraft.com/
> > --
> > TriLUG mailing list :
> > TriLUG Organizational FAQ : http://trilug.org/faq/
> > TriLUG Member Services FAQ : http://members.trilug.org/services_faq/
> TriLUG mailing list : http://www.trilug.org/mailman/listinfo/trilug
> TriLUG Organizational FAQ : http://trilug.org/faq/
> TriLUG Member Services FAQ : http://members.trilug.org/services_faq/
More information about the TriLUG