RE: Including third-party Linux documentation?

[John Posada <JPosada -at- book -dot- com>]

>I'm working on a new SysAdmin guide for users who will be Linux experts. 

1) But they're not Linux experts now?

if that is the case, you cannot expect them to be savvy.

2) When the guide is done, it is for users who are already Linux savvy

if that is the case, don't include too much. However...I'm not a Linux
master, but isn't there slight differences in different Linux flavors? Maybe
syntax differences? Is your documentation for an audience where you know
what flavor? If not, maybe include items where a Linux flavor would have an
impact. 

-----Original Message-----
From: fbelton -at- octigabay -dot- com [mailto:fbelton -at- octigabay -dot- com]
Sent: Friday, May 09, 2003 2:56 PM
To: TECHWR-L
Subject: Including third-party Linux documentation?



Hi all,

I'm working on a new SysAdmin guide for users who will be Linux experts. 

Obviously I don't want to describe the Linux commands and syntax in great
depth in my guide, but am wondering how to make sure all the bases are
covered. Specifically:

- Is it enough to say that users are expected to be Linux savvy in the
document intro and leave it at that?

- Or do some companies also package a basic "off-the-shelf" Linux manual
with their own in-house manuals, and then simply refer to the
off-the-shelf manual when appropriate?

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

Order RoboHelp X3 in May and receive a $100 mail-in rebate, PLUS
free RoboScreenCapture and WebHelp Merge Module. 
 
Order RoboHelp today: http://www.ehelp.com/techwr-l

ATTENTION FrameMaker Users:  Fill-out the following survey 
to receive a chance to win a FREE RoboScreenCapture. 
 
FM users only please: http://www.ehelp.com/techwr-2

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit
http://www.raycomm.com/techwhirl/ for more resources and info.