Re: introducing lists ...

Subject: Re: introducing lists ...
From: "William Sherman" <bsherman77 -at- embarqmail -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 7 Aug 2015 21:36:56 -0400

Well, I have to agree with Lauren, who has thankfully saved me a lot of typing.

Use #2 if you have items in the list to complete the sentence. A colon is required; anything else is incorrect.

Use none if you don't. In that case, make the lead in sentence a complete sentence.



----- Original Message ----- From: "Lauren" <lauren -at- writeco -dot- net>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Sent: Friday, August 07, 2015 6:12 PM
Subject: Re: introducing lists ...


On 8/7/2015 10:29 AM, Sean Brierley wrote:
Question about using lists. Which would you prefer and why? Does a
requirement for translation make a difference? Assume each of the following
fragments is followed by a list that correctly uses parallel structure.

1) This package includes
2) This package includes:
3) This package includes the following:

I go with 2. I have made a stylistic decision that all introductions end
with a colon, be they a fragment or complete sentence. I know that's
contrary to some grammar positions. I also see "the following" as
superfluous, though I am not opposed to adding it if there's good reason;
is there?

A thousand years ago, or was that just two decades ago, I was taught in a Technical Writing class to introduce the list with a complete sentence, unless each list item would complete the sentence. A few examples were discussed in the class and follow. (an example, get it? :-) )

The instructor's preferred form for list introduction follows.
1. Introduce the list with a complete sentence that mentions a list will follow but does not use a leading introduction, like "the following."
2. Use the same construction for each list item; for example, make every item a complete sentence or make each item a fragment.
3. Use at least three list items in a list.
4. Break up very long lists into smaller lists.

The instructor's second choice list form:
1. Leads with a sentence fragment that is ended with a colon.
2. Is followed by list items that complete the introductory fragment.
3. Capitalizes each list item, although the capitalized letter may be lower case in a complete sentence. (I could have remembered that rule wrong.)

An alternative list form is available for single list items that do not require any context, so they do not have closing punctuation, like the types of lists that follow.
1. Option lists
2. Lists of names
3. Descriptive lists, like colors and styles

That technical writing instructor also disfavored lists:
1. that were connected by punctuation;
2. that could be better shown in any of the list alternatives; and
3. used a conjunction before the last list item.

For me, I find a convention that will work with the style guide I am using and will best present the prevalent list usage in the documentation that I am working with. I also keep my choice of lists consistent. Style jumping can make a reader dizzy... Or is that just me that gets dizzy?



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Learn more about Adobe Technical Communication Suite (2015 Release) | http://bit.ly/1FR7zNW

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
introducing lists ...: From: Sean Brierley
Re: introducing lists ...: From: Lauren

Previous by Author: RE: Office/Visio 2010 vs. 2013 ?
Next by Author: Business Glossary
Previous by Thread: Re: introducing lists ...
Next by Thread: RE: introducing lists ...


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads