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.
Subject:Re: Avoid the Semicolon in Tech Writing? From:kcronin -at- daleen -dot- com To:techwr-l -at- lists -dot- raycomm -dot- com Date:Sat, 16 Aug 2003 20:08:54 -0600
I like semicolons, but only half as much as I like colons.
Seriously, though, I *do* like semicolons, and consider them very useful
in both academic writing and literary fiction, where grace, cleverness,
and grammatical prowess can be important skills to display.
However, even I can see where a "no semicolons" rule could be useful in
tech writing. Most readers (and, sadly, many writers) don't really
understand the correct usage of semicolons. And in the "just the facts,
ma'am" syntax used in most tech writing, I really do think you can direct
or instruct the reader effectively without them.
I could see how barring the semicolon could add consistency to a team's
writing by simplifying the rules, and could enhance clarity for readers to
whom the purpose of semicolons is not intuitive.
So, while I've never seen that rule before, to me it makes sense. I think
I'll save my semicolons for my Great American Novel, but I'll give my tech
writing a semicolonoscopy. Thanks for the idea!
Keith Cronin
Would a big truck full of colons be a colon semi?