Re: Hyphenation in technical documentation

Subject: Re: Hyphenation in technical documentation
From: "CB Casper" <knowone -at- surfy -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 02 Dec 2004 07:41:35 -0800


From a personal perspective I really dislike hyphenation,
as someone else mentioned, for it disrupts the flow of
reading.

From a technical writing perspective, our docs include
a lot of technical terms, Unix commands, filenames,
URLs, and other chunks of text that include very
important hyphens. Hyphens at the end of a line
makes it even more difficult to sort out which are
part of the technical term, or part of an end-of-line
hyphen.

I know I'm mixing dashes and hyphens in the above
material, but I don't think most readers know the
difference.

I've come across URLs that are too long for a single
line, and have had a hyphen inserted automatically
that make it very frustrating and many users would
not know the problem and how to correct it to get
to the proper URL.

CB - hyphenless since 1978
--
http://www.surfy.net for Free Email <br> http://www.ergova.com for Low Prices on Hotels, Books, and more.

Powered by Outblaze

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

ROBOHELP X5 - SEE THE ALL NEW ROBOHELP X5 IN ACTION!

RoboHelp X5 is a giant leap forward in Help authoring technology, featuring all new Word 2003 support, Content Management, Multi-Author support, PDF and XML support and much more! View an online demo: http://www.macromedia.com/go/techwrldemo

---
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.



Previous by Author: Pre-requisites for Help Documentation
Next by Author: Re: Technical Documentation using Excel
Previous by Thread: re: Hyphenation in technical documentation
Next by Thread: Re: New Guy Question - MS Word


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


Sponsored Ads