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.
RE: For those who think punctuation matters: validation!
Subject:RE: For those who think punctuation matters: validation! From:"Diana Ost" <Diana -dot- Ost -at- msmcorp -dot- com> To:<beth -dot- agnew -at- senecac -dot- on -dot- ca> Date:Tue, 15 Aug 2006 11:31:58 -0400
I worked in law offices in college, was studying to be an attorney, and
work in policies and procedures now. Yes, I would have caught it, and
have found similar "whoops" in the past. IMHO, depends on your
background, really. I've edited audit reports and legal documents, as
well as very technical scientific papers. The author (attorney,
scientist, etc.) always has to approve the changes anyway. Or at least
they should. <g>
Technical Writer/Reporting Analyst
Market Street Mortgage Corporation
diana -dot- ost -at- msmcorp -dot- com
Phone (727) 431-7209
Fax (727) 724-9096
2650 McCormick Drive, Suite 200
Clearwater, Florida 33759
This message and any attachments may contain confidential or privileged
information and are only for the intended recipient of this message. If
you are not the intended recipient, please notify the sender by return
email or phone, and delete or destroy this and all copies of this
message and all attachments. Any unauthorized disclosure, use,
distribution, or reproduction of this message or any attachments is
prohibited and may be unlawful.
> -----Original Message-----
> techwr-l-bounces+diana -dot- ost=msmcorp -dot- com -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+diana -dot- ost=msmcorp -dot- com -at- lists -dot- techwr-l -dot-
com] On Behalf Of Beth Agnew
> Sent: Tuesday, August 15, 2006 11:10 AM
> Cc: TECHWR-L
> Subject: Re: For those who think punctuation matters: validation!
> It's also a good reminder that NO ONE should "edit" any
> documentation that has a legal purpose, such as license
> agreements, terms of service agreements and other legal
> notices. They may indeed have had a copy editor who put the
> comma IN according to rules of good grammar and it wasn't
> noticed. Unfortunately, the legal beagles never share their
> intentions with the lowly editors, so there would be no way
> of knowing that adding a comma for readability was going to
> substantively change the intent of the contract.
> It's not hard to envision an earnest techwriter giving a
> quick review to all text incorporated into a document and
> dropping in the comma to be helpful, not realizing the
> implications. No one would ever catch it. And I don't think
> there's one of us who hasn't wanted to give the plain
> language treatment to some hefty legalese.
> Here's a case in point that reminds us to be not quite so
> zealous, at least with legal documents.
> > http://www.fftimes.com/index.php/9/2006-08-08/26511
> Beth Agnew
> Catch the Buzz: http://bethbuzz.blogspot.com
> STC Presentation archived at:
> Professor, Technical Communication
> Seneca College of Applied Arts & Technology
> Toronto, ON 416.491.5050 x3133
> WebWorks ePublisher Pro for Word features support for every
> major Help
> format plus PDF, HTML and more. Flexible, precise, and
> efficient content
> delivery. Try it today! http://www.webworks.com/techwr-l
> Easily create HTML or Microsoft Word content and convert to
> any popular Help file format or printed documentation. Learn
> more at http://www.DocToHelp.com/TechwrlList
> You are currently subscribed to TECHWR-L as diana -dot- ost -at- msmcorp -dot- com -dot-
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
> To subscribe, send a blank email to techwr-l-join -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.
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l