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: Chapter summaries at start of doc: yes/no? From:"Martinek, Carla" <CMartinek -at- zebra -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 24 Oct 2006 11:36:58 -0500
We have a table that shows a summary of all the chapters. One column
with the chapter title, one with the descriptive sentence about what's
in it.
We create our docs in Framemaker, and we link directly to the both the
chapter title and the description at the beginning of the chapter. Once
it's set up, there's no additional maintenance as it is kept current
whenever the cross-refs are updated.
Carla
cmartinek|zebra|com
-----Original Message-----
From: techwr-l-bounces+cmartinek=zebra -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cmartinek=zebra -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Sarah Bouchier
Sent: Tuesday, October 24, 2006 11:32 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Chapter summaries at start of doc: yes/no?
>My template also calls for some introductory text immediately after the
>chapter title and before the first Head1 pgf.
I'm actually talking about summaries of all the chapters at the
beginning of the document. The ones right before the chapter begins
tend to be updated, because they're more noticeable.
Sarah Bouchier
Technical Author
exony
- CONFIDENTIAL-
This email and any files transmitted with it are confidential, and may also be legally privileged. If you are not the intended recipient, you may not review, use, copy, or distribute this message. If you receive this email in error, please notify the sender immediately by reply email and then delete this email.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-