RE: Chapter summaries at start of doc: yes/no?

Subject: RE: Chapter summaries at start of doc: yes/no?
From: "Jessica Weissman" <Jessica -dot- Weissman -at- hillcrestlabs -dot- com>
To: "Sarah Bouchier" <Sarah -dot- Bouchier -at- exony -dot- com>
Date: Tue, 24 Oct 2006 13:34:01 -0400



For an ordinary API or user doc I wouldn't put in those summaries. They
serve little purpose (unlike a small advance organizer at the start of a
chapter/section), and are hard to keep up to date.

If your topic needs an overview, it may make sense as a separate Getting
Started doc. Yes, I realize those two concepts aren't exactly the same,
but sometimes the Getting Started doc does what an overview is supposed
to do.

Anecdote: when I was developing CBT I worked with a PhD instructional
designer who had an overview for every topic, including multiple-choice
interaction. We canned those extra screens right away, especially since
the same stuff in the same words was repeated not too much later. She
even had an introductory page for the overview.

You can justify it in instructional design theory terms, but not in
deadline terms.

Jessica Weissman
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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-

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%40infoinfocus.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/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: RE: Release notes
Next by Author: RE: Re: If Bill Gates is such a great philanthropist . . .
Previous by Thread: RE: Chapter summaries at start of doc: yes/no?
Next by Thread: Re: Chapter summaries at start of doc: yes/no?


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


Sponsored Ads