Re: Style Guide for UNIX?

Subject: Re: Style Guide for UNIX?
From: <neilson -at- windstream -dot- net>
To: Julie Stickler <jstickler -at- gmail -dot- com>, TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 17 Oct 2008 11:14:40 -0500

Julie wrote:

> step starts with a lower case letter. This looks odd to me, and I'm
> not sure if this is acceptable when documenting UNIX?

Folks using the unix (or linux) shell command-line are going to be adept at the non-graphic interface already. They will expect to see "cd blah-blah" but will also be able to reconstruct the correct command from docs that went through a fierce editorial staff person who capitalized or upper-cased everything. They've seen it before. They still won't like it.

--Peter Neilson




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

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

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.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/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Style Guide for UNIX?: From: Julie Stickler

Previous by Author: Re: "Picklist"
Next by Author: Re: perspective on rates
Previous by Thread: Re: Style Guide for UNIX?
Next by Thread: RE: Style Guide for UNIX?


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


Sponsored Ads