RE: Hardware Documentation

Subject: RE: Hardware Documentation
From: "Martin Polley" <Martinp -at- Surf-com -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 14 Oct 2002 10:03:10 +0200

Depending on the product, you may find that test documents may also be
important (that is, documents that describe tests to be performed on a
product or system, and documents giving the results of these tests).

In telecom, many systems are expected to comply with certain standards.
Tests show whether they do or not. Test documents show customers that
your system does what it was designed to do.


Martin Polley
martinp -at- surf-com -dot- com
Surf Communication Solutions
Tavor Building
tel +972 (4) 9095732
PO Box 343
fax +972 (4) 9594055
Yokne'am 20692
mobile +972 (53) 864280
ICQ 15617901

-----Original Message-----
From: Shea Michael EXT [mailto:Michael -dot- Shea -dot- extern -at- icn -dot- siemens -dot- de]
Sent: Monday, October 14, 2002 9:46 AM
Subject: RE: Hardware Documentation


The kind of documents you need are dependent on the needs of your
customer. I am currently documenting telecommunication equipment. The
kinds of things that need to be decribed are as follows:

How do I physically install it.
How do I get it running.
How do I install and operate the management software.
How do I maintain the equipment and troubleshoot problems.
What are the features of the system and what do they mean or how does it
fit in the big picture.

That is what is required by my customer. Whether it meets your
customer's needs is another question. You may notice that really these
are the same kinds of questions you answer when you document software.

How do I install it.
What do I do with it.
How do I get it to do what I want.
What do I do when things go wrong.

MILspec is only necessary for the military or if that is what your
customer prefers. It isn't required by the telecom business, nor the
semiconductor business; the other hardware writing that I have done.

As a side note, your customer is really choosing a bad time to try and
break in to the telecom business. The news is full of telecom companies
laying off workers by the thousands and tens of thousands.

Michael Shea
XpressLink Documentation

Michael Shea
Am Schlossberg 14, D-82547 Eurasburg, Germany

Phone: +49 8179 9307-19, Fax: +49 8179 9307-12
E-Mail: shea -at- r-l -dot- de, Web:

All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at

Buy ComponentOne Doc-To-Help 6.0, the most powerful SINGLE SOURCE HELP
AUTHORING TOOL for MS Word. SAVE $100 on the full version and $50 on the
upgrade. Offer ends 10/31/2002 (code: DTH102250).

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 for more resources and info.

Previous by Author: RE: What to call access keys
Next by Author: RE: cross reference updates in Word97
Previous by Thread: RE: Hardware Documentation
Next by Thread: RE: Hardware Documentation

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

Sponsored Ads