RE: Heading Hierarchy for a Complex Manual

Subject: RE: Heading Hierarchy for a Complex Manual
From: "Neumann, Eileen" <ENeuman -at- franklintempleton -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 7 Nov 2005 12:23:38 -0500


Hi Kirk,

I think you need to keep in mind that good styles will be different for online than for print. I believe the Chicago Manual focuses on print. Underlining anything is not recommended online, as the reader can confuse this with a link.
As well, my preference would be for a greater difference in point size between heading levels. 14 pt seems pretty small for heading 1, and doesn't leave much room for differentiating between levels. My preference only...

Cheers,
Eileen

-----Original Message-----
From: bounce-techwr-l-177285 -at- lists -dot- techwr-l -dot- com [mailto:bounce-techwr-l-177285 -at- lists -dot- techwr-l -dot- com] On Behalf Of Kirk Turner
Sent: Monday, November 07, 2005 12:16 PM
To: TECHWR-L
Subject: Heading Hierarchy for a Complex Manual


I am in the process of editing a very long and complex manual. I am
writing the style guide, and I am on the section on heading hierarchy.
Except for the unwieldy APA guidelines, I haven't found any guidance on
the subject. I have the Chicago Manual of Style guidelines, but I don't
see any examples or suggestions that relate to what I am doing. But I
used what was in the Chicago Manual of Style anyway and came up with
these levels of heading (this is for an online manual):

. The first level heading will be Verdana, 14 pt., upper and lower
case, underlined and centered.

. The second level will be Verdana, 14 pt., centered, uppercase and
lowercase.

. The third level will be Verdana, 12 pt., flush left, uppercase and
lowercase and underlined.

. The fourth level heading will be Verdana, 12 pt., one tab from left
and capitalized as it would be in a sentence.

. The fifth level of heading will be Verdana 12 pt., two tabs from the
left and underlined. End this heading with a period and begin the first
sentence of the body text for this heading on the same line as the
heading.


Does this sound right? Is the Chicago Manual of Style a good reference
for a complicated technical manual? I have an example using it on paper,
and it looks odd to me. Most of my editing jobs have been for technical
journals. I hate to question the venerable Chicago Manual of Style, but
this looks odd. Is there a more authoritative source for technical
manuals? Have I interpreted the Chicago heading hierarchy correctly?
Maybe it is just fear of failure clouding my vision. Any guidance would
be greatly appreciated.



Notice: All email and instant messages (including attachments) sent to
or from Franklin Templeton Investments (FTI) personnel may be retained,
monitored and/or reviewed by FTI and its agents, or authorized
law enforcement personnel, without further notice or consent.

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

Try WebWorks ePublisher Pro for Word today! Smooth migration of legacy
RoboHelp content into your new Help systems. EContent Magazine Decision-
maker review (October 2005) is here: http://www.webworks.com/techwr-l

Doc-To-Help 2005 converts RoboHelp files with one click. Author with Word or any HTML editor. Visit our site to see a conversion demo movie and learn more. 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.



Previous by Author: RE: Un-underlined?
Next by Author: RE: Bone-headed Question
Previous by Thread: Re: Heading Hierarchy for a Complex Manual?
Next by Thread: RE: Heading Hierarchy for a Complex Manual


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

Sponsored Ads


Sponsored Ads