How to document a programming language?

Subject: How to document a programming language?
From: "Sarah Bouchier" <Sarah -dot- Bouchier -at- exony -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 8 Mar 2007 16:56:38 -0000

I've been documenting software for a good few years now, and I know how
to do that; but I'm now looking at documenting QA's test harness, and to
be honest I haven't the faintest clue where to start.

I could do a basic 'these are the commands, this is what they do, here
are some examples' but the commands are in some ways the least of it;
the default values the test harness assumes are also very important, and
there are a number of cunning little tweaks the QA manager has put in
that are highly non-intuitive.

I'd appreciate a pointer or two :-)

Sarah Bouchier
Technical Author



Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

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

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


Previous by Author: RE: [TCP] certification (was: ranting STC)
Next by Author: RE: Changing progams to accommodate reviewers
Previous by Thread: RE: Old PC Technology (was: RE: certification; was: ranting STC)
Next by Thread: Re: How to document a programming language?

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

Sponsored Ads