TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I agree with David - I don't see anything inconsistent with your examples.
The information seems clear and the differences aren't jarring. But if you
want to keep a similar structure for all your sentences, there are a few
things you can do. First, decide how you want to present the information
or what rules you want to follow. For example, you could have other
writers or editors follow these rules:
When using technical terms:
Follow the first use of a term with the definition in parenthesis.
"I see a mermaid (a woman with a fishtail who swims in the ocean) in the
distance."
When adding "that is" info to a sentence:
Follow with i.e. and text in parenthesis.
"I see many mermaids (i.e., more than 100) in the distance."
When adding "for example" info to a sentence:
Follow with e.g. and text in parenthesis.
"I see dozens of strange creatures (e.g., mermaids, mermen, and dragons)
in the distance."
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.