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: Space Before and After? (long) From:"Combs, Richard" <richard -dot- combs -at- Polycom -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 26 Jan 2005 10:07:56 -0700
Catching up on a the last few digests, I noticed that Alan Quirt wrote:
> I have always used Space After each body text paragraph
> style, and both Space Before and Space After for headings,
> choosing the amount by eye. As a technical person whose
> documents were a by-product, that was good enough.
>
> Now I am trying to make technical writing a career, and want
> to do better.
> Can you offer advice on how to choose good values for
> paragraph spacing?
> Should it be based mostly on font size? Should it be greater
> when margins are wider? Do particular kinds of document need
> special treatment?
Alan, you've gotten some good advice -- and some not so good (promise me
you won't use equal space above and below on all your headings). I want
to address two issues, one not mentioned at all and the other only
touched on: (1) space above vs. space below, and (2) the software you're
using.
Above vs. below: Dave Chinell acknowledged using a "fallacious
argument... to justify my mysterious, innate desire to design with space
before." I'd like to clear up the mystery, because Dave's desire makes
sense.
Assuming you agree with Geoff Hart, Damien Braniff, and most of the
civilized world <g> that related items should be closer to each other
than unrelated items, you'll want additional space above headings. To
accomplish this with space below settings only, you'd have to have
special paragraph styles/formats just for use above a heading --
BodyLast, Bullet1Last, etc., etc. And even then, you'd be limited to the
same space above all headings.
So, it makes far more sense to control the primary spacing variables in
your doc -- the space above headings -- by using the space above
settings of your heading paragraphs. Simplicity and consistency then
suggest sticking with space above for your other paragraphs, too.
Depending on the software you're using, it could be very important; see
below.
Software: I can only speak to Word and FrameMaker (I've forgotten what
Interleaf, Ventura, and PageMaker do, it's been so long). In FrameMaker,
the space between two paragraphs is the *greater* of the space below the
first and the space above the second. So you can set things up like
this, for instance:
Probably not what you want. In Word, I strongly recommend using only
space above for all paragraphs. Mixing space above and space below
settings seems inevitably to lead to confusion and unintended
interactions. It gets too complicated having to consider "Will a Heading
3 follow a body indent? Will a bullet follow a Heading 4? What
about...?"
In FM, some people like to set a space below that's the minimum space
they ever want between paragraphs -- the 6pt setting in the example
above, for instance. But the primary setting is the space above, and in
most situations, it governs (because it's equal to or larger than the
space below of the preceding pgf).
Personally, I leave almost all the space below settings at zero, just as
in Word (I have a few special-purpose exceptions, such as a table anchor
paragraph). If all paragraphs have an appropriate space above, you don't
need a minimum space below.
HTH!
Richard
------
Richard G. Combs
Senior Technical Writer
Voyant, a division of Polycom, Inc.
richardDOTcombs AT polycomDOTcom
richardDOTcombs AT voyanttechDOTcom
303-223-5111
------
rgcombs AT qwestDOTnet
303-777-0436
------
WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo: http://www.webworks.com/techwr-l
Technical Communication Certificate online - Malaspina-University College, Canada. Online training in technical writing, software (FrameMaker, RoboHelp, Dreamweaver, Acrobat), document & web design, writing manuals, job search. www.pr.mala.bc.ca/tech_comm.htm for details.
---
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.