RE: Re: Writing procedures - thanks

Subject: RE: Re: Writing procedures - thanks
From: "Chris Vickery" <cvickery -at- arenasolutions -dot- com>
To: "Pro TechWriter" <pro -dot- techwriter -at- gmail -dot- com>, "Anindita Basu" <anindita -dot- basu -at- in -dot- ibm -dot- com>
Date: Tue, 18 Aug 2009 14:46:40 -0700

It's not that a note element can't be located in a step, it's that that
a note element cannot be located *directly* in a step element. Note can
be located in an info element, which can itself be in a step element.

So <step><cmd>some text</cmd><info><note><p>Here's the note

The idea is that the note is part of the step, but is not part of the
cmd text.

You can always customize your DTD if you are so inclined, as well.

Christopher Vickery
Technical Content Manager
Arena Solutions
cvickery -at- arenasolutions -dot- com
p. 650.513.3530 | m. 650.513.3500 | f. 650.513.3511
4100 E. Third Ave., Suite 300, Foster City, CA 94404


Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control!

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

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:

Re: Re: Writing procedures - thanks: From: Pro TechWriter
Re: Re: Writing procedures - thanks: From: Anindita Basu
Re: Re: Writing procedures - thanks: From: Pro TechWriter

Previous by Author: Re: Visio/Office guru?
Next by Author: Style guide for Environment, Health, and Safety?
Previous by Thread: Re: Re: Writing procedures - thanks
Next by Thread: Teaching a practical business writing class and looking for professional rubrics

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

Sponsored Ads