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 opinion.
Greg On 4/13/06, John Mitchell <[EMAIL PROTECTED]> wrote: > > Maybe he was paid by the word(more words = more money). > > johnm :) > > On 4/13/06, Rick DeNatale <[EMAIL PROTECTED]> wrote: > > .. is this not one of the worst written pieces of technobabble you've > seen? > > > > http://www.htmlgoodies.com/beyond/javascript/article.php/3470971 > > > > 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 : > http://www.trilug.org/mailman/listinfo/trilug > > 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/ > -- 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/
