Re: "Allow" vs. "Require"
You did misinterpret, but it's my fault. The trouble probably started
when I tried to get cute with the Yiddish. We're actually talking about
an optional field in a dialog box.
I was picturing, as I described yesterday, the location settings in Drupal.
The tutorial instructions use "enable" for enabling various fields and "allow" as one option for collection settings.
Why the longer versions? Why not just, "the Number of Bears field is
mandatory, the Color of Bears field is optional"? Because some of my
target audience prefers requirements that begin with, "The RCP shall..."
or "The RCP shall not..."
Are they lawyers?
Some of the Rules are imperatives, cast in the terms "shall" or "shall not." These define proper conduct for purposes of professional discipline. Others, generally cast in the term "may," are permissive and define areas under the Rules in which the lawyer has discretion to exercise professional judgment. ... Many of the Comments use the term "should." Comments do not add obligations to the Rules but provide guidance for practicing in compliance with the Rules.
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.
Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.
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-leave -at- lists -dot- techwr-l -dot- com
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
- RE: "Allow" vs. "Require", Dan Goldstein
Search our Technical Writing Archives & Magazine