Re: What's THAT for?

Subject: Re: What's THAT for?
From: Sally Derrick <sjd1201 -at- gmail -dot- com>
To: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
Date: Thu, 5 Aug 2010 09:39:51 -0500

I would go with your first option. It's not cool to leave those things
undocumented. IMO, that looks like an error and makes me wonder about what
else is missing from the docs.

Sally


On Thu, Aug 5, 2010 at 9:35 AM, McLauchlan, Kevin <
Kevin -dot- McLauchlan -at- safenet-inc -dot- com> wrote:

>
> In documenting a hardware product that uses a chassis
> common to several other of your company's products,
> how do you refer to unused physical features like (say)
> an electrically live USB port or a specialty port that
> doesn't have a function in the current product.
>
> My default reaction is to just stick arrows and letters
> on such items in the diagram, and then in the call-out
> list say (for items "e" and "f" in this case):
>
> a. ....framistan
> b. ....doohickey
> c. ....thingamajig
> d. .... network ports 0 and 1
> e. (Not used in this application - do not connect)
> f. (Not used in this application - do not connect)
> g. Hot-swap power supply 1
> h. Hot-swap power supply 2
> i. ..........
>
> There's no danger of loss or damage. If you connect something
> to those ports, simply nothing useful happens, and whatever
> you thought might happen... probably doesn't, not even a bad
> smell... probably.
>
> OR
>
> Is it cool to have curious little items like that simply
> ignored? Not acknowledged in the docs at all? (I vote "no"
> on that, but I would be happy to learn counter-arguments.)
>
> Kevin McLauchlan
> Senior Technical Writer
> SafeNet, Inc.
> --
>
> <bumpf-starts-here>The information contained in this electronic mail
> transmission
> may be privileged and confidential, and therefore, protected
> from disclosure. If you have received this communication in
> error, please notify us immediately by replying to this
> message and deleting it from your computer without copying
> or disclosing it.
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Gain access to everything you need to create and publish information
> through multiple channels. Your choice of authoring (and import)
> formats with virtually any output. Try Doc-To-Help free for 30-days.
> http://www.doctohelp.com/
>
> LavaCon 2010 in San Diego Sept 29 - Oct 2 is now open for registration.
> Use referral code TECHWR-L for $50 off conference tuition!
> See program at: http://lavacon.org/
>
>
> ---
> You are currently subscribed to TECHWR-L as sjd1201 -at- gmail -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/sjd1201%40gmail.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
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days.
http://www.doctohelp.com/

LavaCon 2010 in San Diego Sept 29 - Oct 2 is now open for registration.
Use referral code TECHWR-L for $50 off conference tuition!
See program at: http://lavacon.org/


---
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:
What's THAT for?: From: McLauchlan, Kevin

Previous by Author: Re: Anyone have an idea?
Next by Author: Re: Flare questions
Previous by Thread: What's THAT for?
Next by Thread: Re: What's THAT for?


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

Sponsored Ads


Sponsored Ads