Web Writing That Works!

           A Project of
           The Communication Circle

Guidelines Rants Patterns Poems Services Classes Press Blog Resources About Us Site Map

HomeGuidelines > 4. Build chunky paragraphs. > 4a. Design each paragraph around one idea.          

 

Diagram

Background

Examples

Audience Fit

Challenges

Bonus! Hot Text chapter (121K, PDF, 2 minutes at 56K)

4a. Design each paragraph around one idea.

  • Consider each paragraph a distinct object.  As an object, it has one main purpose.  Figure out what that purpose is, and highlight that throughout.
  • If you are writing in XML, treat each paragraph as an element. What is the subject?  What are you trying to do with this element?  Why are you including it? 
  • Press Return.  Break up long complicated paragraphs into a series of short ones.
  • Throw out irrelevant topics. If they are important, put them in their own paragraphs.  If trivial, discard.
  • If you cannot figure out what the real point is, your reader cannot either.  Make sure that the real point appears in a distinct sentence within the paragraph.  If it does not, your paragraph has no core.
  • Make all the sentences cohere. Each should contain words that relate to your main topic.  Skip the thesaurus, too.  If you are referring to the same thing over and over, use the same word.
  • See and signal the structure.  For instance, if you are working in chronological order, use words such as first, next, and finally.
  • Proceed from the familiar to the new, throughout. Start with the known, and end a sentence with the new.  Then start the next sentence with that new idea, creating a chain.

Other ways to make chunky paragraphs:

4a.  Design each paragraph around one idea.

4b. Put the idea of the paragraph first.

4c. If you must include context, put that first.

4d. Put key conclusions, ideas, news, at the start of the article.

 

  Diagram

 
 

 

 

 

 

 

 

 

 

 

 

 

Background

Business readers are skimmers; many go weeks at a time without reading a paragraph all the way through. —Weiss (1991)

One idea per paragraph (users will skip over any additional ideas if they are not caught by the first few words in the paragraph). —Nielsen (1997b)

One point per paragraph. —Bricklin (1998)

Each paragraph should contain one main idea; use a second paragraph for a second idea, since users tend to skip any second point as they scan over the paragraph. —Sun (2000)

Paragraphs have plots, patterns that organize sentences into a whole unit. --Young, Becker, and Pike (1970).

See bibliography: Bricklin (1998), Bush and Campbell (1995), Dragga and Gong (1989), Morkes & Nielsen (1997), Nielsen (1997a, 1997b), Quirk (1972), Sammons (1999),  Sun (2000), Weiss (1991), Williams (1990), Young, Becker, and Pike (1970).

Examples

Original Paragraph

ActiveX controls are just one part of the whole ActiveX technology, and we should really focus our attention there. ActiveX itself is a revision of Microsoft’s early OLE standards, which competitors found too desktop-centered. The modifications to ActiveX technology help make network objects more secure, more usable on multiple platforms, and smaller, so they move faster across the network. Of course, some competitors argue that ActiveX and DCOM do not interoperate with multivendor open object standards such as CORBA, and Microsoft has said it will upgrade to work with CORBA, but has not done the implementation at this time. The basic idea behind ActiveX technology is to support platform-independent, reusable software objects, so that an intranet or the Internet can offer a broad assortment of prebuilt functions.

Revised Paragraph

The modifications to ActiveX technology help make network objects more secure, more usable on multiple platforms, and smaller, so they move faster across the network. The idea behind ActiveX technology is to support platform-independent, reusable software objects, so that an intranet or the Internet can offer a broad assortment of prebuilt functions.

Of course, some competitors argue that Microsoft has not gone far enough, even in this revision of ActiveX technology, and its related standard, DCOM. The competitors argue that ActiveX and DCOM do not interoperate with multi-vendor open object standards such as CORBA, and Microsoft has said it will upgrade to work with CORBA, but has not done the implementation at this time.

Resources on chunkiness

Taking a Position on chunkiness

Poster

 

 

Audience Fit
 
If visitors want... How well does this guideline apply?
To have fun People out for entertainment sometimes like long tangled paragraphs, enjoying the rich prose, without restlessly asking, "What's the point?"
To learn Critical. Providing one idea at a time helps the mind absorb the argument.
To act Critical.  Each instruction deserves its own paragraph.  Move explanations into their own paragraphs, separate from the steps.
To be aware If simplicity is a virtue for you, follow the guideline.
To get close to people In e-mail and discussion groups, focusing each paragraph on a single idea helps people see what you mean.  Nonstop rants, without paragraphing, are just self-indulgent.

Ready for some challenges?

 

 

Home | Guidelines | Rants | Patterns | Poems | Services | Classes | Press | Blog |
Resources | About Us | Site Map

Web Writing that Works!
http://www.WebWritingThatWorks.com
 © 1999-2004 Jonathan and Lisa Price
The Communication Circle
Discuss at HotText@yahoogroups.com
Email us directly at ThePrices@ThePrices.com
Order Hot Text (the book) from Amazon