RE: introducing lists ...

Subject: RE: introducing lists ...
From: "David Artman" <david -at- davidartman -dot- com>
To: "Sean Brierley" <sean -dot- brierley -at- gerberscientific -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 07 Aug 2015 12:45:39 -0700

I'd go with this construction:

This package includes these [ items | parts | applications | or
whatever specific class of items is listed ]:

* Blah

* Blah

I would do so for two reasons:

1. It's a full sentence, not a fragment.

2. It doesn't rely on reading direction, unlike "following" (or "below"
or other relative-position term).

IIRC, this is what A Major IT Company has in its style guide. They do A
LOT of translation. ;)

David

-------- Original Message --------
Subject: introducing lists ...
From: Sean Brierley <[1]sean -dot- brierley -at- gerberscientific -dot- com>
Date: Fri, August 07, 2015 1:29 pm
To: "[2]techwr-l -at- lists -dot- techwr-l -dot- com" <[3]techwr-l -at- lists -dot- techwr-l -dot- com>
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:

References

1. mailto:sean -dot- brierley -at- gerberscientific -dot- com
2. mailto:techwr-l -at- lists -dot- techwr-l -dot- com
3. mailto:techwr-l -at- lists -dot- techwr-l -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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


Previous by Author: RE: "Software Technical Writing is a Dying Career"
Next by Author: RE: "Software Technical Writing is a Dying Career"
Previous by Thread: RE: introducing lists ...
Next by Thread: Re: What comes after Appendix Z


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

Sponsored Ads


Sponsored Ads