[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: Thinking like a user, or sticking to tried and true?

Subject: Re: Thinking like a user, or sticking to tried and true?
From: "Barry Campbell" <barry -dot- campbell -at- gmail -dot- com>
To: "David Castro" <thejavaguy -at- gmail -dot- com>
Date: Thu, 21 Dec 2006 08:18:38 -0500

On 12/21/06, David Castro <thejavaguy -at- gmail -dot- com> wrote:

...think like a user and leave off the overview, or create one
because "there's always been one" and because "it's good practice to
start by telling them what you're going to tell them and end with
telling them what you told them."

Which do you do when you're faced with this decision? And why?

Make the title of the Overview section "About This (Document, Guide,
etc.)," provide an executive summary and then briefly orient the
reader to what the document covers in each section, and you're done.

- bc

--
Barry Campbell -- <barry -dot- campbell -at- gmail -dot- com>
Blog: http://campbell-online.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

Create HTML or Microsoft Word content and convert to Help file formats or printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. 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.

References:
Thinking like a user, or sticking to tried and true?: From: David Castro

Previous by Author: Re: ISTC
Next by Author: Re: Should we go to Structured FrameMaker
Previous by Thread: Re: Thinking like a user, or sticking to tried and true?
Next by Thread: Re: Thinking like a user, or sticking to tried and true?

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

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

Sponsored Ads