Value of design documents (was: New TECHWR-L Poll Question)

Subject: Value of design documents (was: New TECHWR-L Poll Question)
From: "Hart, Geoff" <Geoff-H -at- MTL -dot- FERIC -dot- CA>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 15 Jan 2001 10:12:17 -0500

Donald Le Vie reports: <<I've had training and experience with NASA's
specification development methodology (from the Software Assurance
Technology Center), and their methods/templates can be extremely rigorous
for obvious reasons. >>

<g> Maybe they used to be, but the program seems to have been renamed
"Software-Hardware Assurance For Technology". As the press have maliciously
noted, Hubble and several recent Mars missions seem to have gotten the
SHAFT.</g>

<<Specs can be developed in formal language, but very few people who must be
able to read and understand the spec will be able to do so as formal
language is strongly mathematical in nature. Instead, specs are developed
using natural language to facilitate the understanding by all parties of the
requirements and contractual obligations. The problem with natural language
is one we deal with every day: it introduces ambiguity, inaccuracy, and
inconsistency.>>

Witness the problem with choice of units of measurement that sank the Mars
Explorer probe. Maybe it's time for someone to take that formal language for
spec development and make it a little more usable by common mortals, as was
done for SGML (resulting in HTML)? Sounds like a nice project for someone
with expertise and time. Maybe STC could fund it?

--Geoff Hart, FERIC, Pointe-Claire, Quebec
geoff-h -at- mtl -dot- feric -dot- ca
"User's advocate" online monthly at
www.raycomm.com/techwhirl/usersadvocate.html

"Technical writing... requires understanding the audience, understanding
what activities the user wants to accomplish, and translating the often
idiosyncratic and unplanned design into something that appears to make
sense."--Donald Norman, The Invisible Computer

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17)
http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.

Sponsored by DigiPub Solutions Corp, producers of PDF 2001
Conference East, June 4-5, Baltimore/Washington D.C. area.
http://www.pdfconference.com or toll-free 877/278-2131.

---
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.


Previous by Author: USAGE: Enables?
Next by Author: Textbook writing: don't just blame the authors!
Previous by Thread: RE: search for web-based help
Next by Thread: RE: Value of design documents (was: New TECHWR-L Poll Question)


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


Sponsored Ads