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.
Subject:Re: Style Guide for UNIX? From:beelia <beelia -at- gmail -dot- com> To:"Janice Gelb" <Janice -dot- Gelb -at- sun -dot- com> Date:Sat, 18 Oct 2008 18:09:41 -0700
Better yet, rather than annoy your SME, take a class.
On Sat, Oct 18, 2008 at 6:05 PM, beelia <beelia -at- gmail -dot- com> wrote:
> No, not for you. My point is that it depends on your experience and
> understanding. If you don't know UNIX is case-sensitive, you might
> want to ask such questions.
>
>
>>
>> I think that any time you aren't sure you understand
>> a step-by-step procedure you need to consult your SME,
>> no matter which OS you're documenting. I'm afraid I
>> don't agree that specifically for UNIX documentation
>> you need to consult your SME "before you change the
>> smallest thing." Changing "3. cd to the directory" to
>> "3. Change to the directory using the cd command" is
>> not a change that needs to be brought to an SME for
>> verification.
>>
>> -- Janice
>>
>> ***********************************************************
>> Janice Gelb | The only connection Sun has with
>> janice -dot- gelb -at- sun -dot- com | this message is the return address
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> 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 beelia -at- pacbell -dot- net -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/beelia%40pacbell.net
>>
>>
>> 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
>>
>>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-