TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Paragraph numbering - industry standard? From:siliconwriter -at- comcast -dot- net To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 03 Aug 2005 18:32:01 +0000
I?ve been documenting software for years now, and am writing my first SDK. I hate, hate, HATE paragraph numbers; I think they?re a holdover from when most tech writers worked for the military and had to conform to mil specs. My question is: is it still an industry standard to put paragraph numbers on each and every freakin? paragraph? Most of the commercial, third-party programming books I?ve seen don?t do that.
It isn?t as simple as asking the developers what they?d like. They write their documentation with and without numbers, but that may be a matter of being unfamiliar with Word?s numbering capabilities. :) And in any case, they keep telling me that since I *am* the tech pubs department, it?s up to me to establish standards. So...before I alienate all my customers by giving way to a personal preference, I?d like to poll you folks who write SDKs and software documentation to find out what the common practice in the field is.
Thank you.
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.