Re: Declarative vs. imperative

Subject: Re: Declarative vs. imperative
From: Stan Schwartz <stanz -at- cam -dot- org>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 6 Jun 2002 00:07:59 -0400

At 4:12 PM -0400 6/5/02, Ruby Isaacs wrote:

Will you please post your editorial advice for the following situation? It's for a colleague of mine.

"I am working on a manual of procedures concerning safety for inspectors and have come across a mishmash of text that switches from....declarative statements such as 'Inspectors must always....' to ones addressed directly to the reader that are imperative such as 'you must never ... you are required to be....'

As a related sidebar, I hasten to encourage using the positive instead of the negative. Stress what should be done rather than what should not be done.

Check out RoboDemo for tutorials! It makes creating full-motion software
demonstrations and other onscreen support materials easy and intuitive.
Need RoboHelp? Save $100 on RoboHelp Office in May with our mail-in rebate.
Go to

Free copy of ARTS PDF Tools when you register for the PDF
Conference by May 15. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD.

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.

Wired article on "RTFM": From: Sandy Harris
Declarative vs. imperative: From: Ruby Isaacs

Previous by Author: RE: Adobe Acrobat and Document Management
Next by Author: Writing for a particular audience
Previous by Thread: Re: Declarative vs. imperative
Next by Thread: Re: Declarative vs. imperative

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

Sponsored Ads