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.
At 01:18 PM 10/14/97 -0500, Miark wrote:
>I'm debating whether to begin numbering chapters at the intro,
>or the subsequent chapter. I've got a pile of guides here from other
>companies, and almost all of them begin after the intro section. I
>did that for my last guide, but I wonder whether that invites readers
>to completely skip the intro.
>
I think it depends on what information you have in your intro. I prefer to
put generic material like doc conventions, doc set overview, and intended
audience for the manual in a Preface before the TOC. I put the Introduction
as Chapter 1 immediately following, containing information introducing the
current product or whatever else *this* manual covers.
>How do you approach this issue, as small as it is?
>
>Thanks,
>Mike
>
--
Martha Jane {Kolman | Davidson}
editrix -at- slip -dot- net / mjk -at- netcom -dot- com / mjk -at- synon -dot- com
Senior Technical Writer
"If I am not for myself, who will be for me?
If I am only for myself, what am I?
If not now, when?"
--Rabbi Hillel
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html
