Friday, November 26, 2010

But How Does It LOOK?

Hello, Readers,
Sorry, but I cannot make the heading colors match :-(


Make Your Document Look Inviting

I like the Japanese proverb, We eat first with our eyes. The fact is, we value presentation, whether with food or a document. Here are some tips for making a good impressionmaking the big picture invitingbefore readers actually read a word. You will recognize some tips from earlier posts, but they also belong here to round out this list. Confession: Youll note that in Blogspot, I can't do some of what I recommend below.

Tips for Paragraphs That Welcome the Reader
1. Write short paragraphs: If you expect folks to read a paragraph, limit it to no more than ten lines in a document and even fewer in a letter or email.

2. Space between paragraphs: The resulting white space makes a document more inviting.

3. Dont indent paragraphs: When you space between paragraphs, there is no need to indent. Actually, some fancy writers indent only the first paragraph and thats okay.

Tips for Lists

1. Do make lists!
Lists make your document look more accessible and more organized. You can even make a list under a list under a list! Just indent and align them like you would with an outline.

2. In a list, begin with numbers: If you need several levels of lists, begin with numbers. And tab or indent only twicenot the default five spaces. For a second-level list, use bullets, and for a third level, use hyphens or en dashes. With one short list, bullets work well, but they need to be large enough to make a point: consider bold or a larger size.

3. Indent hierarchical lists: Especially with lists followed by sublists, use the outline format and place subsequent lines under the text above. Don't return to the margin (like I had to do here).


General Tips
1. Use ragged right margins:
Justified margins really frustrate me. We read in little fixations
words in a phrase that belong together (of the people). So having phrases spaced out makes the reading less smooth.

Editors say they can actually see rivers of white in justified text. I think it looks like someone randomly pulled teeth. Interestingly, most professionally produced documents use ragged right margins, at least part of the time, including newspapers, magazines, and brochures. I am waiting for electronic books to move in that direction. I note that the larger the text, the more the words are spaced out. And Id also like to see large-print books use ragged-right margins.

2. Avoid all caps: Readability experts have observed that all capital letters in a text make it more difficult to read. They lack the irregular coastline of upper/lower case. Additionally, they take up more space, thus limiting the font size.

In October of this year, New York City applied this insight to all their street signs. At a cost of $110 per sign, the city began changing street signs from all caps to upper/lower case. With 250,900 signs to deal with, the cost to the state is $27.6 million.
Their rationale: the new signs are easier to read, enabling drivers to spend less time with their eyes averted from the road and thus save lives.

3. Keep related words on the same line: Happily, with a ragged-right margin, you can cheat a little at the end of a line: you never have to type clear to the end. If a word almost fits, but ends up on the next line, you can move the margin a little to the right and keep the word where it belongs. If a word at the end of the line belongs with the phrase on the next line, just send it there. The more conspicuous the document isin PowerPoint slides or on a posterthe more important this issue becomes. Below is a quote set in the middle of a column followed by my fix:

If we can open your mind to laughter, we can slip in a little information.
If we can open your mind to laughter,
we can slip in a little information
.

Cartoon captions are frequently guilty. In an all-caps Marmaduke cartoon, his master asks:

HOW MANY TIMES HAVE I TOLD YOU ABOUT BEG-
GING AT THE TABLE?
How many times have I told you
about begging at the table?

4. Use plenty of headings: Yes, Ive emphasized it before, and you can review this advice is in an earlier blogHow Readable is Your Document? Headings provide white space and display organization. They make a document look much more accessible.

5. Attend to the micro stuff:
Make
curly quotation marks and apostrophes your default. For this blog, I had to import what I wanted and copy and paste it each time: Blogspot's only option is to use "Stick" quotes like these. In contrast, you can make the curly kind your default. Additionally, I cannot make em dashes in Blogspot--they remain just two hyphens. However, in Word and most other programs, when you type two hyphens between words without spacing on either side, the hyphens magically turn into an em dash.

Caveat: Friends, it pains me to admit this: in Blogspot, I cannot do all that I suggest in this blog. When I try to do a forced return to put a word on the next line and when I tried to indent to align lists, I created chaos. In fact, an earlier version of this blog was so bad I chose to delete it and begin again. So, it is that old cliche:
Do as I sayand so will Iin any other circumstance.

Next Time: What About the Passive Voice?

Tuesday, June 8, 2010

How Readable Is Your Document?

Make it Readable
In business writing (and maybe even for love letters), readability is an important criterion. We are impatient readers, and we dont want to be impressed, just informed. Below are several tips to make what you write more accessible.
1. Tell the reader in the first paragraph where you are going: I have analyzed the data and found three reasons for recommending X. (With an email, use an informative subject line.) 
2. Write short sentences: Limiting sentences to 15 or 20 words, makes for easier reading. Ive actually gotten lost in sentences that were several times that long.   
3. Use simple words: Words longer than two syllables require more time to process. Compare these: long words and multisyllabic words. The more time a reader spends processing vocabulary, the less energy is available for processing the meaning of the message.
Note: Readability experts recommend using no more than an eighth-grade vocabulary, regardless of the educational level of your reader. Heres how you find it: 1) Use the grammar checker. 2) Limit your syllables per word to 1.5 and your words per sentence to 15 or 20. Tip: With instructions, consider using a fifth-grade vocabulary.
4. Repeat key words: If your English teacher encouraged you to use a thesaurus, she was helping your vocabulary, but not your clarity. A better suggestion: Change a word only when you have changed its meaning. Insiders may know that you are playing with synonyms, but your primary audience could well become confused. I once challenged a document that used both kidney stones and renal gravel. The writer informed me that the terms were synonyms and thought she would bore the reader if she repeated the same term. I assured her that if they were my kidney stones, I'd want to keep track of them.
5. Use your own professional voice: Heres a great test: Read aloud what you have written. If listening to yourself makes you gag or laugh, rewrite it: Please be advised that we are herewith forwarding, under separate cover. . . . Gag, indeed. If you write the way you speak to professional colleagues or an audience, your readers will think you sound natural and friendlyand will trust you more.

6. Use lots of lists: Lists break up the page and tell the reader that you have organized your material. You can even use a list under a list, under a list. Just use the normal outline model to show what fits under what. With instructions, always use lists. (Dont use a paragraph to tell me how to get to your house.)

7. Use headings: If you plan before you writejotting down key ideas and their supportyou can use an abbreviated form of each key idea as a heading to begin each new section of your document. (Look at the books for dummies section of the bookstore. The content may still be tough, but the multiple headings make it look easy.) 

Next time: But How Does It Look? 

Sunday, May 2, 2010

National Teacher Appreciation Week

Can you read this? Thank a teacher!

This is the week—May 3–7—and now is the time, time to acknowledge and celebrate!

Think back. What gift do you remember from a special teacher: Praise? Training? Comfort? Direction? Even discipline? And then ask yourself,
Does the teacher even know how I benefited from the experience and that I appreciated it? This week offers you an ideal opportunity to sit down with pen and paper and let the teacher know.
 

Of course, on the Internet, you can find hundreds of canned ways to communicate: buy a card, email a card, copy a poem. However, nothing trumps authenticity.

Saying thank you on paper makes a powerful impact in our telephone, email culture. These simple guidelines will let you create a truly effective letter.


1. Be specific, not merely general, in your celebration or thanks.
Not: You were a wonderful teacher.
Rather: Do you remember when you told me I really had talent and you looked forward to reading about my successes?
 
2. Share how the issue made you feel.
Because you believed in me, I began to believe in myself and envision new possibilities.
 
3. Identify the positive impact on you—immediate or long-term.
I began to work with more purpose and actually began to enjoy studying harder. Looking back, I can see thats when my self esteem began to increase. And now my dream has come true! I am enclosing an invitation to my first show (or a copy of my book), etc.
 
Of course, the outcome may not be so dramatic, and it could be many little things that you remember and appreciate. If the teacher is still employed, send a copy to the chair of the department, the principal, the dean, etc.


Please believe that your letter will be a
You made my day event and will be preserved. In fact, you may be surprised how many others hear about it. You’ll be glad you took the time!

Here's a related tip: 

This recipe works for all sorts of good-will letters: thanks, congratulations, and compliments! They are good-will letters because that is what they will generate for you: lots of good will!

Saturday, March 13, 2010

That Tricky Little Apostrophe

No piece of punctuation takes more abuse than the apostrophe. In fact, the popular little book, Eats, Shoots, and Leaves, seems inspired primarily by samples the author has collected of misuse of the apostrophe, mostly by famous people. And they abound!
For fun, here is a brief review highlighting some key areas of concern. You decide: Are these sentences correct or not?
1. Name the mall that rewards it
s customers. (from an ad)
2. Your going to be very surprised.
3. It
s not uncommon to see this error.
3. This is the Smiths
land.
4. We bring greetings from the Smith
s.
5. This aisle contains apple
s, oranges, and grapes.
6. The 1970
s offered many opportunities.
7. The mens
hats are on that rack.
8. This is Charles
book.
9. This is Charles
s book 

Dont use apostrophes in normal pluralsouch!
But I thought the teacher said to use an apostrophe with an s.
• generation
s, cups 
Delicious (from the Apostrophe Protection Society in
   London   

Chips, Sausages, Rolls, Eggsfrom Bennys Cafe (a real    sign)
Use apostrophes with pronoun contractions, but not with possessive pronouns
With pronouns, an apostrophe indicates a contraction, some fairly unusual, but quite acceptable in all but legal language: they
ve, were, youd, shes, youre Im, its (a contraction for it is). However, with possessive pronouns, the possession is indicated by the pronounnever by an apostrophe: ours, his, hers, yours, theirs, its (the possessive formno apostrophe). In fact, #2 above is one of the most common punctuation errorsand is the reason I included this reminder!

Use apostrophes for clarification
To avoid confusion, an apostrophe is used with single letters and with the plural form of lower case abbreviations: two s
s in the word, three bccs, his pjs. When no confusion would result, no apostrophe is needed: 1970s, CPAs, DVDs. Caution: This does not work for names. If your name is Smith, you cant get byeither on you mailbox or your holiday greetingwith the Smiths. If you want to be sure we know your name does not end in s, consider: the Smith Family or John and Mary Smith, or give up and use a simple plural: the Smiths.

Follow these steps for real possessive apostrophes
Here
s my three-step approach for most uses of the possessive apostrophe.
1. Begin with the normal word, singular or plural
who
    owns (possesses) it?
the men, some girls, a child.
2. Add an apostrophe: the men
, some girls, a child
3. Add an s if there is not one: the mens, some girls, a
    child
s
Note that the apostrophe always goes after the normal word: men (I see the men; not I see the mens, so not mens
).
If something is owned jointly, one apostrophe will serve: the cat and the dog
s master. If possession is separate, two apostrophes indicate that: the catss and the dogs food. 

Names cause trouble: Although the same rules apply with names, people get confused. If John Smith owns something, it is John Smiths. If they are separate owners, it is Johns and Marys. If John and Mary Smith own something jointly, it is John and Mary Smiths, Mr. and Mrs. Smiths, or the Smiths.
Here
s a related cause for trouble: words, especially names, ending in s or an s sound: Charles. So, which is right, Charles or Charless? This is one of those interesting areas where we confront divided usage: either could be right. I love the Gregg Reference Manuals suggestion here: Listen to yourself. If you make Charles one syllable, then one s will doand is cleaner. However, if you make it two syllables, you can convey your pronunciation with the additional s. This is true of other words that end in s: if you hear it, add an s: Congresss task, the witnesss statement.

Here are some answers
1. Name the mall that rewards it
s customers.
2. You're going to be very surprised.
3. It
s not uncommon to see this error.
3. This is the Smiths
land.
4. We bring greetings from the Smith
s.
5. This aisle contains apple
s, oranges, and grapes.
6. The 1970
s offered many opportunities.
7. The men
s hats are on that rack.
8. This is Charles
book.
9. This is Charles
s book

There is much more. For further exploration, I suggest the Gregg Reference Manualmy favorite resource. It has many pagesjust on the apostrophe!

Wednesday, March 3, 2010

Happy National [Good] Grammar Day: March 4

Grammar Still Matters to Most Literate Readers
When you are tempted to push the envelope and decide that many traditional grammar rules have become irrelevant, beware. If, for example, you choose the traditional all right instead of the more casual alright, no one will notice, even those who choose to use alright. Yet if you use alright, conservative readers will likely wince. Acceptable grammar usage changes slowly, and this is not a movement where you benefit from being in the forefront!

Here's a little quiz where you can identify what might be considered incorrect and then fix it: 
1. His goal was to always win.  
2. Richard and him were the last ones hired.
3. The secret must remain with you and I.
4. They gave the gift to John and myself.

5. Accuracy of movement, like accuracy of words, are essential     to the success of magical rites. 

6. Where is he at?

7. We are striving to make the world a better place to live in.   
 

Comments on the Quiz
1. You may recognize to win as an infinitive. Although conservative writers choose never to split one (as I just avoided), many grammarians suggest that you
listen to yourself and see how it soundsalways a good idea when you write. I don't like the sound of this split infinitive, so I might say, His goal was always to win (or) His goal was to winalways. On the other hand, here is a familiar and wonderful split infinitive: To boldly go . . . .

2. Unfortunately, this pronoun error still creeps into good writing. Fixing it may require separating the parts of the subject: Richard was hired. He was hired (both subject words). Richard and he were hired.


3. This is such an uncomfortable error that it clearly causes listeners to squirm; again, separating the two object words helps clarify: with you, with I. Whoops! With you and (with) me.

4. The pronoun myself cannot stand aloneeither as a subject or an object. Use it only after you use I: Ouch, I hurt myself (or) I did it myself.

5. When a phrase is set off from the subject, it must be ignored when choosing the verb to use: Accuracy of movement is essential.

 6. Ending a sentence with a preposition has a bad, and undeserved, reputation because too many people fail to see the difference in a proposition and a verb phrase. Clearly, Where is he at? and Where are you going to? are inappropriate because they are redundant. Where is he? and Where are you going? serve the same purpose.

7. Here, live in is a verb phrase, different from live. I am comfortable with this sentence. Of course, if you want to avoid any question, you could use the somewhat stuffy phrase, in which to live.

I challenge you to consider every day a good grammar day!




    Saturday, February 20, 2010

    What is a Semicolon?

    Punctuating Two Cores in One Sentence
    Heres an assertion I encountered when working on my dissertation: Adults rarely use semicolons incorrectly; in fact, they rarely use semicolons! (Still, I have observed some wonderfully creative uses.) However, I am not proposing a greatly increased use of semicolons. What I am suggesting is that there are places where they are useful and places where they are incorrect. You just oughta know which is whichand what your other options are!
    Semicolons serve to separate two Cores in one sentence. Well get there, but first lets just consider how and why we might put two Cores together in the first place when they could be two separate sentences:
    1. They are logically related.
    2. The are parallel.
    3. They are short. 

    Punctuation Options for Two Cores in One Sentence
    1. Cores can be connected with a comma plus and, or, but:
    I like coffee, and she likes tea.
    I like coffee, but she does not.
    Notice that the only pause is after coffee. (We
    d never pause after but.) And if you know these are coordinate conjunctions, you probably dont need to read this!
    2. Cores can be connected with a semicolon: a soft period. This means the Cores, again, could be separate sentences. So, the semicolon requires a Core on each side.
    I like coffee; she prefers tea.
    Dark chocolate is not just better
    ; it is better for you. Incidentally, don't use a semicolon with and, or, but (except as indicated in # 6 below).
    3. Cores can be connected with a qualifying word or phrase: however, moreover, furthermore, on the other hand:
    I like coffee; however, she prefers tea.

    Although these connectors look like and or but, they are not. Notice that while and and but are stuck between the two cores, these words can move around: I like coffee; she, however, prefers tea. I like coffee; she prefers tea, however. Unfortunately, many writers do not see (or hear) the difference and tend to punctuate them the same. 
    Heres what I often find: I like coffee, however she prefers tea. Whoops, just read the sentence aloud to test it. In fact, this is a sentence with two Cores where the second Core is preceded by the introductory word, however. Without the semicolon, this is a terrible error: a comma splice.
    4. The second Core can serve as an explanation for the first Core: They have canceled the event: there is too much snow. Arguing purely from punctuation, one could use a semicolon here (they are both Cores); however, these two sentences dont just sit side-by-side: in fact, the second explains the first, and only the use of a colon predicts that for the reader (remember yoo hoo.”)
     
    5. Semicolons can serve to separate sets of words in a sentence when the sets contain internal commas: Were excited to be considering venues in these locations: New York, Monday, April 5; Boston, Monday, April 12; and Baltimore, Tuesday, April 20. (If the list is long or complicated, I'd strongly advise presenting the information in a table.)

    6. Commas serve to separate a series of short Coresusually: I walked the walk, I talked the talk, but I did not fool anyone. However, if one or more of the items in the series contains an insert, it is necessary to separate the items with semicolons: I walked the walk; I talked the talk; but, in fact, I did not fool anyone. (Remember, dont use commas at two levels in the same sentence.) And, finally, note that when you do use a semicolon after the first Core, you must also do so before the and or but.
    I think these guidelines have addressed the key ways to use a semicolon. And I hope they make sense, because their function is really to help you help your reader.


     

    Thursday, February 11, 2010

    symbol

    Punctuation: Traffic Signals in a Sentence

    Structural Punctuation in a Sentence
    First, here is a little punctuation quiz.
    (Just add punctuation and justify it.)

    1. When I called Jane came running.
    2. We moved to Liberty Missouri years ago.

    3. My best friends Tom Dick and Harry enjoy my corny humor.
    4. These are my best friends Tom Dick and Harry.
    5. Here is why I like them they laugh at my jokes! 
    (Answers below)
    Punctuation is not arbitrary! It makes sense because it makes a sentence flow. I have received a variety of interesting requests to address punctuation, especially the comma! What I want to present is a logical analysis of a sentence to show where punctuation fits and where it does not. Heres a practical tip: Listen to yourself. If you hear a pause, feed itbut, please, not always with a comma. 

    Analyzing the Core Sentence
    Instead of using grammatical language, let me begin with the simple idea of a Core: the essence of a sentence. When a set of words comprises a story
    an actor and action; a subject and a predicatewe have a sentence. For example: John reads books. Sue reads slowly. The children are happy with their books.
    Notice two features of these Core sentences:

    1. As you read each basic Core sentence aloud, you do not pause; therefore, you have nothing to feed until the period.
    2. At the end of a Core sentence, your voice falls. In contrast, here is a bunch of words where your voice would rise to indicate a lack of closure: After thinking about the problem for weeks and asking countless questions . . . . Clearly, this is not a story; in fact it is that awful monster, a fragment.

      Punctuating Before the Core: the Introductory  
      It is quite appropriate to create a sentence with
      attachments to the Core. However, because the Core is the basic structure for meaning, any attachments must be indicated with punctuation!

      Before the Core
      , a comma functions to convey the pause (as it did in this sentence). It may also serve to avoid temporary ambiguity, as in After I called Bill answered. (Actually, I did not call Bill
      but that is what the sentence first seems to convey.)
      After I called, Bill answered. (Now, the ambiguity is gone.)
      Since the writer always knows what is intended and may not recognize an ambiguity, The Gregg Reference Manual suggests always using the introductory comma, even with very brief introductory elements. The Associated Press Stylebook disagrees and first wants the writer to first determine if there might be an ambiguity. But most of us don
      t write for the press, so why not do it the easy way?
      Punctuating Within the Core: Inserts
      An insert is a group of words within the Core that provides useful information, but is not essential to the Core. An insert actually results in two audible breaks when read aloud and needs two pieces of matching punctuation to set it off: a pair of commas, a pair of parentheses, or a pair of em dashes.
      1. My younger sister, who lives nearby, is a good friend.
      2. Your book (in case you hadn
      t noticed) is overdue.
      3. Three very important people
      my spouse, my best friend, and     my supervisorwill help me.
      Some comments on my punctuation:

      1. For the first sentence, a pair of commas works best because this is a simple insert, and there is no other internal punctuation. With an emphatic statement, I could also have used a pair of em dashes. (An em dash is two hyphens with no space on either side.)

      2. For the second sentence, instead of a pair of parentheses, I could again have conveyed emphasis with a pair of em dashes. (Commas do not provide an adequate break here.)

      3. For the third sentence, a pair of em dashes is necessary for two reasons: (a) Setting the series off with commas would create confusion because commas are already associated with the list. Tip: Never use commas at two levels at once.
      (b) Parentheses convey material that is
      parentheticalnot so important. Clearly, that's actually contradictory here.
      Further Explanation after the Core
      Information after the Core has punch! Here
      s what I mean: BAM! The end of the Core is a great place for a word or phrase, a series, or even an explanatory sentence. 

      For a word or phrase following the Core, there are three punctuation options: a comma, a colon (my favorite), or an em dash.
       I have one important goal
      survival! Compare that sentence with this one: Survival is my most important goal. (Clearly this second sentence lacks punch.)
      For a series, there are only two punctuation options: a colon or an em dash. Using a comma to set off a series would truly be confusing. I like to think of the colon as a Yoo hoo: it is a clear signal that whatever follows the Core will point back to and elaborate on the Core itself. I really enjoy these three fruits: mangoes, passion fruit, and pineapple. An em dash also works hereif the statement is emphatic. 

      For an explanatory sentence after the Core sentence, a colon serves best: It clearly conveys that the second Core explains the first. I have one request: please come early. An em dash here would convey emphasis, but otherwise, it looks too casual. Although a semicolon is grammatically correct between the two sentences, it fails to convey that the second Core explains the first, and thus a semicolon is not helpful here. (More in a later posting.) 

      Answers: Remember, it is not enough to be right, you need to know why!
      1. When I called, Jane came running. (an introductory to avoid ambiguity)
      2. We moved to Liberty, Missouri, ten years ago. (an insert
      hear the pause?)
      3. My best friends
      Tom, Dick, and Harryenjoy my corny humor. (an insert)
      4. These are my best friends: Tom, Dick, and Harry.     
          (an explanation after the Core)
      5. Here is why I like them: they laugh at my jokes!
          (an explanation after the Core)