Re: What do you call your examples?

Subject: Re: What do you call your examples?
From: Milan Davidovic <shl_ctf -at- yahoo -dot- ca>
To: Sarah Bouchier <Sarah -dot- Bouchier -at- exony -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 30 Aug 2007 12:12:56 -0400 (EDT)

--- Sarah Bouchier <Sarah -dot- Bouchier -at- exony -dot- com> wrote:
> I don't know what to name the
> examples.

This is for user names in screen examples. Perhaps it
could be adapted to work for company names. It's very
square (as in L7) and dull, but it alleviated a number
of concerns (arising from the nature of the product
and the business) that would be too lengthy to get
into here

For a product I used to work on: normal human first
name + number (written as words). For example, Sally
Six (obviously, if you add 63 to that you'll offend
someone, but that's easy enough to avoid; "four" might
have been tricky, though we never heard anything).

In the system I was writing about, we had different
categories of users, and if more than one appeared on
a given screen, they couldn't have the same last name.
Therefore, we assigned numeric ranges to each user

Hope this helps.


Get a sneak peak at messages with a handy reading pane with All new Yahoo! Mail:

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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 for more resources and info.

What do you call your examples?: From: Sarah Bouchier

Previous by Author: Re: STC Style Guide
Next by Author: Getting an early start on Friday: docs in pop songs
Previous by Thread: RE: What do you call your examples?
Next by Thread: RE: What do you call your examples?

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

Sponsored Ads