Re: introducing steps

Subject: Re: introducing steps
From: Char James-Tanny <charjtf -at- gmail -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 19 Oct 2011 13:29:42 -0400

> This is actually the compromise my teacher and I have settled on: each procedure will be introduced with a level 4 header,which is basically body font + bold. (I like the touch of omitting the colon - thanks for that nicety) .  What this means is that some level 2 and level 3 headers will be followed by a level 4 header with no intervening text, which I have been told is a no-no, but visually it will work.  Each step is, in itself, a complete sentence.
>
> I have no problem with starting procedures with an independent clause if I could figure out a way to do it without excess verbiage and that will sound good. I'm open to ideas!

Instead of always using Heading 4 (which will violate the structural
integrity of the document), you could create a new style (for example,
"Task Heading") for these topics.

Char James-Tanny ~ JTF Associates, Inc. ~ http://www.helpstuff.com
----------------------------------------------------------
Please send follow-up questions to the list. (Inquiries sent off-list
may not be seen.)
Contact me directly (CharJT at jtfassociates dot com) with business inquiries.
----------------------------------------------------------
Microsoft Help MVP since 2002
Find a Help Authoring Tool at HAT-Matrix.com ~ http://hat-matrix.com
Web site Hosting and Design ~ http://www.jtfhosting.com
Author of "Learning Author-it"
W3C WAI Invited Expert ~ Education and Outreach Working Group
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Re: introducing steps: From: Michael West
Re: introducing steps: From: Becca

Previous by Author: RE: Technical writing as a trade; was, RE: Give Me a Clear Thinker (was STC certification: what's in it for tech writers?)
Next by Author: Re: What would replace WebHelp?
Previous by Thread: Re: introducing steps
Next by Thread: RE: introducing steps


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


Sponsored Ads