RE: Text format of user inputs (paper manuals)

Subject: RE: Text format of user inputs (paper manuals)
From: "Beth Kane" <BethKane -at- TCISolutions -dot- com>
To: <TECHWR-L -at- LISTS -dot- RAYCOMM -dot- COM>
Date: Thu, 16 Sep 1999 09:14:52 -0700

I agree that using quote marks is bad, because _someone_ is going to end up
typing 'em in the command line. One thing we've done in many manuals, and it
was very clear to users, was put commands on a separate line and indented a
little bit, as in:

To get started building your own dog kennel, type:

homecrate <Enter>

The Homemade Crate window appears.

(Any keys that need to be pressed are shown within angle brackets.)
bethkane -at- tcisolutions -dot- com

-----Original Message-----
In a software training manual, how should I format the text that users have
to enter? At the moment, we have:

Type "Report on Angle Model" in the <bold>Title</bold> box.

..Has anyone any better ideas?

Previous by Author: RE: Which came first: the manual or the help?
Next by Author: RE: Multiple checkouts with FrameMaker?
Previous by Thread: Re: Text format of user inputs (paper manuals)
Next by Thread: RE: Proposals: Let's Get Cynical, Cynical, I wanna get Cynical...

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

Sponsored Ads