Re: Style Guide for UNIX?

Subject: Re: Style Guide for UNIX?
From: "Janet Swisher" <jmswisher -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 17 Oct 2008 14:33:31 -0500

FWIW,

The GNOME Documentation Style Guide says "Do not use commands as
verbs" and "Avoid starting a sentence with a command name or
application name that has a lowercase initial letter".

http://library.gnome.org/devel/gdp-style-guide/stable/grammar.html.en

(GNOME is a desktop environment for Unix.)



On Fri, Oct 17, 2008 at 1:25 PM, John Posada <jposada99 -at- gmail -dot- com> wrote:
> However, I don't think it's what you want anyway. I have mione in
> front of me. While it is from SUN, it is OS agnostic...it doesn't
> differenciate. It addresses approaches to different tech writing
> aspects, such as how to arrange callouts, how to index, grammar and
> usage, hypenatioon guidelines, typefaces, punctuation, some project
> management, etc.
>
> If you are looking for how to format command lines and such, I'd
> probably get a good *NIX book and follow the examples.
>
> On Fri, Oct 17, 2008 at 1:53 PM, Julie Stickler <jstickler -at- gmail -dot- com> wrote:
>> On Fri, Oct 17, 2008 at 1:27 PM, John Posada <jposada99 -at- gmail -dot- com> wrote:
>>> It's from Sun. They ONLY do *nix. To include it would be redundant
>>
>> Ah! Thank you, I did not know that.
>>
>> *adds book to shopping list*



--
Visit my blog at: http://www.janetswisher.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

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


Follow-Ups:

References:
Style Guide for UNIX?: From: Julie Stickler
Re: Style Guide for UNIX?: From: Chris Morton
Re: Style Guide for UNIX?: From: Julie Stickler
Re: Style Guide for UNIX?: From: John Posada
Re: Style Guide for UNIX?: From: Julie Stickler
Re: Style Guide for UNIX?: From: John Posada

Previous by Author: Re: the liaison between or the liaison among??
Next by Author: Re: Info about online Master's degree programs from U.S
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