[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference thebay::joyoflex

Title:The Joy of Lex
Notice:A Notes File even your grammar could love
Moderator:THEBAY::SYSTEM
Created:Fri Feb 28 1986
Last Modified:Mon Jun 02 1997
Last Successful Update:Fri Jun 06 1997
Number of topics:1192
Total number of notes:42769

25.0. "Clear Writing is Concise" by NY1MM::SWEENEY () Fri Oct 26 1984 00:42

tangent from 2.13

Clear writing communicates effectively.  If your goal is to lie or to confuse,
then, by all means, use such prose.  If your goal is to communicate use words
that will make your ideas easily understood.

Nixon inspired a style of speaking and writing that demonstrated to many
that the corruption of personal integrity and vocabulary go together.

Pat Sweeney
T.RTitleUserPersonal
Name
DateLines
25.1NACHO::LYNCHFri Oct 26 1984 10:235
I couldn't agree with you more, Pat. Too often the bloated prose I referred
to is written by people who are trying to impress you with their verbiage,
not their ideas.

-- Bill
25.2DOSADI::BINDERFri Oct 26 1984 10:508
Absolutely true.  There is a longstanding adage which says, "If you can't
dazzle 'em with brilliance, baffle 'em with bullsh*t."  What's particularly
annoying is that we see so much of that sort of thing in the electronics
business; it often appears, for example, in owner's manuals and similar
publications that should by definition be clear and concise.

Cheers,
Dick
25.3PNEUMA::ILSLEYTue Oct 30 1984 10:594
I'd like see some examples of particularly offensive passages in Digital
publications (especially owner's manuals). I'm an editor at the Maynard
Educational Services site. An MY at the bottom of a reader's comments card
indicates the manual was produced in Maynard.
25.4FDCV01::BEAIRSTOThu Jan 17 1985 13:016
George Orwell wrote a wonderful essay called "Politics and the English
Language" which discusses the relation of thought and speech, and how
clarity (or its lack) carries over from one to the other. I highly
reccommend it.

Rob
25.5NY1MM::SWEENEYThu Jan 17 1985 20:084
This essay can be found in "The Orwell Reader" which you can buy at better
bookstores for less than $10.00.

Pat Sweeney
25.6GRAFIX::EPPESThu Jan 24 1985 14:1239
This quote is included in the "Effective Written Communication Student
Guide" (that you get when you take the Effective Written Communication of
Technical Information workshop given by Bob Marotta).  According to the
guide, this quote was written by A. Ecclesine (whoever that is) and appeared
in "Printer's Ink" a few years ago:


	When you come right down to it, there is no law that says you
	have to use big words when you write or talk.

	There are lots of small words, and good ones, that can be made
	to say all the things you want to say, quite as well as the
	big ones.  It may take a bit more time to find them at first.
	But it can be well worth it, for all of us know what they mean.
	Some small words, more than you might think of, are rich with
	just the right feel, the right taste, as if made to help you
	say a thing the way it should be said.

	Small words can be crisp, brief, terse -- go to the point, like
	a knife.  They have charm all their own.  They dance, twist,
	turn, sing.  Like sparks in the night they light the way for the
	eyes of those who read.  They are grace notes of prose.  You know
	what they say the way you know a day is bright and fair -- at
	first sight.  And you find, as you read, that you like the way
	they say it.  Small words are gay.  And they can catch large 
	thoughts and hold them up for all to see, like rare stones in 
	rings of gold, or joy in the eyes of a child.  Some make you
	feel, as well as see:  the cold deep dark of night, the hot 
	salt sting of tears.

	Small words move with ease where big words stand still -- or worse,
	bog down and get in the way of what you want to say.  There is not
	much, in all truth, that small words will not say -- and say
	quite well.


Notice that there aren't any words containing more than one syllable.....!

							-- Nina
25.7AKOV68::BOYAJIANFri Jan 25 1985 04:175
Well, I'll be superamalgamated!

(Any Doc Savage fans out there?)

--- jerry
25.8VIA::LASHERThu Jan 31 1985 22:122
... and you may have alienated the sesquipedallianists (no claims made on
the correctness of that spelling)
25.9METEOR::CALLASMon Feb 04 1985 20:019
I once inserted this sentence into a project plan just to see if anyone
was really paying attention:

        The project manager will also ensure that the status reports are
        disseminated in an effective communicatory manner while eschewing
        superfluous, sesqipedalian, or obfuscatory verbiage, and will
        eliminate and eradicate each and every redundancy.


25.10Ghost::DEANTue Feb 05 1985 17:103
Jon,

Was anyone really paying attention?
25.11GRAFIX::EPPESTue Feb 05 1985 18:364
RE .9 -- Yeah, that's great!  Did you get any response?  Maybe I should try
it in my next doc plan (Digitalese for "documentation plan")...

							-- Nina
25.12MILOS::CALLASTue Feb 05 1985 22:222
Alas, yes, they were paying attention. It got a few good laughs, though. A
couple peple who knew me well came to my office laughing.
25.13PUFFIN::GRUBERMon Feb 18 1985 15:269
Re .0 --

I see Pat's point; what I wonder about is how William Safire fit into the
Nixon administration (linguistically, not ideologically).

Also, who wrote Spiro Agnew's speeches -- remember the alliteration:
"nattering nabobs of negativism" etc.?

                  -mg_
25.14SUPER::KENAHTue Feb 19 1985 17:444
In a Sunday Times Magazine article a few months back, Safire admitted writing 
the "nattering nabobs of negativism" speech.

					andrew
25.15VIA::LASHERMon Mar 04 1985 11:292
Another advantage of concise writing is that it allows hundreds of noters
to read notes files more quickly over the NET.
25.16Conciseness from a master (not me!)THEBAY::GOODMANUncle RoyThu Mar 13 1986 21:5215
    I hope this isn't already entered in this file somewhere, but it seemed
    germane to the topic, so here goes.  It comes from a book called
    _The_Elements_of_Style_ by William Strunk Jr. and E.B. White--a book
    which, if you don't own one already, you should get a copy of at the
    earliest opportunity.
    
         Vigorous writing is concise.  A sentence should contain
         no unnecessary words, a paragraph no unnecessary
         sentences, for the same reason that a drawing should
         have no unnecessary lines and a machine no unnecessary
         parts.  This requires not that the writer make all his
         sentences short, or that he avoid all detail and treat
         his subject only in outline, but that every word tell. 
         
    Roy
25.17The word compressorBRAHMS::KOCHKevin Koch LTN1-2/B17 DTN226-6274Fri Jun 13 1986 16:2110
     Here is an example of some DECspeak I found in a spec, and what I 
reduced it to, after running my 'word compressor' on it.  

     Before:  "Table 1-2 provides a list of related documents 
containing additional information pertaining to the Nautilus system.  
The references listed in the table refer to documentation available 
at the system level only."

     After:  "Table 1-2 lists additional documents pertaining to the 
Nautilus system.  The list refers to system-level documentation only."