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.
-----------------------------
Sharon Burton asked of visual learners:
What I am wondering is if you visual learners out there would like to see an example report as well?
-----------------------------
Speaking as a visual learner, I say stick 'em in. The examples will provide a milestone of sorts to measure what the user is supposed to have against what they actually ended up with.
-----------------------------
And if I show example reports, do I show them in the chapter in place, thus making each topic that talks about a report pretty long (even if I shorten the example) or do I put them at the end of the chapter or ?
-----------------------------
Put each example in place. If you're creating online help of some kind, you can stick a thumbnail of the report into the topic that opens a full-size image of the example in a separate window. We do that with our report examples.
The one thing I would caution, though, is that you choose your examples carefully and that explain very carefully any variations that may show up between the example and what the user will actually get. One of the problems with examples and visual learners (at least with this visual learner) is that I rely on the picture more than the words and if there is something different between the example and what I get I am confused for a couple of seconds before I realize I need to actually read something. :-)
ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl
COMPONENTONE DOC-TO-HELP 7 PROFESSIONAL: From a single set of Word documents, create online Help and printed documentation. New version offers yearly subscription service, Natural Search, Modular TOC Utility, Image Map Editor, Theme Designer, Context String Editor, plus more. http://www.componentone.com/doctohelp .
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.