Thread Links Date Links
Thread Prev Thread Next Thread Index Date Prev Date Next Date Index

RE: stds-80220-requirements: Shall-Will-Should in 802.20 Requirem ents v5 - C802.20-03-6921




 Hi,

This means to use the definitions provided by me in C802.20-03/67:

"MUST" or "SHALL" These words or the adjective "REQUIRED" means that the
item is an absolute requirement. 
"MUST NOT" This phrase means that the item is an absolute prohibition. 
"SHOULD" This word or the adjective "RECOMMENDED" means that there may exist
valid reasons in particular circumstances to ignore this item, but the full
implications should be understood and the case carefully weighed before
choosing a different course.
 "SHOULD NOT" This phrase means that there may exist valid reasons in
particular circumstances when the listed behavior is acceptable or even
useful, but the full implications should be understood and the case
carefully weighed before implementing any behavior described with this
label.
 "MAY" This word or the adjective "OPTIONAL" means that this item is truly
optional. One implementation may include the item because the target
marketplace requires it or because it enhances the product, for example;
another implementation may omit the same item.

Marianna


-----Original Message-----
From: Joanne Wilson
To: Klerer Mark; 'Joseph Cleveland'; stds-80220-requirements@ieee.org
Sent: 7/24/2003 12:08 AM
Subject: RE: stds-80220-requirements: Shall-Will-Should in 802.20 Requirem
ents v5 - C802.20-03-6921

Hi!
 
I support use of the IEEE style manual across the board.  I believe that
Bob Love provided a good explanation of how
"will" should (shall?) be used based on the IEEE style manual.  His
comment was as follows:
-----Original Message-----
From: owner-stds-80220-requirements@majordomo.ieee.org
<mailto:owner-stds-80220-requirements@majordomo.ieee.org> 
[mailto:owner-stds-80220-requirements@majordomo.ieee.org]On Behalf Of
Robert Love
Sent: Wednesday, July 23, 2003 10:09 AM
To: stds-80220-requirements@ieee.org
<mailto:stds-80220-requirements@ieee.orgSubject> Subject:
RE: stds-80220-requirements: Shall-Will-Should in 802.20
Requirements v5 - C802.20-03-6921
I am in general agreement with Joseph's recommendations for the use of 
"shall" and "should" which closely follow the style guide. I would
advise 
that we attempt to limit the use of "will" for explanations that
describe 
conditions that naturally follow from set conditions so there is no 
confusion over the possibility that we must be able to conformance test
for 
the condition. An example of "will" being used according to this
guideline 
is: "Loss of signal will result in dropped packets."
Best regards.
Robert D. Love
rdlove@ieee.org <mailto:rdlove@ieee.org> 
------------------------------------------------------------------------
---------------------------
Best regards,
Joanne
-----Original Message-----
From: owner-stds-80220-requirements@majordomo.ieee.org
[mailto:owner-stds-80220-requirements@majordomo.ieee.org]On Behalf Of
Klerer Mark
Sent: Wednesday, July 23, 2003 4:51 PM
To: 'Joseph Cleveland'; 'stds-80220-requirements@ieee.org '
Subject: RE: stds-80220-requirements: Shall-Will-Should in 802.20
Requirem ents v5 - C802.20-03-6921


Joseph, 

That is the right approach. The only question remaining is if we need a 
definition of "will" as proposed by Joanne. 

Mark Klerer
 
-----Original Message-----
From: Joseph Cleveland [mailto:JClevela@sta.samsung.com] 
Sent: Wednesday, July 23, 2003 2:10 PM
To: 'stds-80220-requirements@ieee.org '
Subject: RE: stds-80220-requirements: Shall-Will-Should in 802.20
Requirem ents v5 - C802.20-03-6921
 
Hi All, 
Thanks to Vladimer Yanover the IEEE has a statement in the style
manualSection 5, para 13.1, for use of shall, will, should, etc.  I
recommend that we use the IEEE statement, which I have copied below:
"The word shall is used to indicate mandatory requirements strictly to
be followed in order to conform to the standard and from which no
deviation is permitted (shall equals is required to). The use of the
word must is deprecated and shall not be used when stating mandatory
requirements; must is used only to describe unavoidable situations. The
use of the word will is deprecated and shall not be used when stating
mandatory requirements; will is only used in statements of fact.
The word should is used to indicate that among several possibilities one
is recommended as particularly suitable, without mentioning or excluding
others; or that a certain course of action is preferred but not
necessarily required; or that (in the negative form) a certain course of
action is deprecated but not prohibited (should equals is recommended
that).
The word may is used to indicate a course of action permissible within
the limits of the standard (may equals is permitted).
The word can is used for statements of possibility and capability,
whether material, physical, or causal (can equals is able to)."
Joseph Cleveland 
-----Original Message----- 
From: Vladimir Yanover [ mailto:vladimir.yanover@alvarion.com
<mailto:vladimir.yanover@alvarion.com> ] 
Sent: Tuesday, July 22, 2003 10:36 PM 
To: 'Joanne Wilson '; 'Joseph Cleveland ';
'stds-80220-requirements@ieee.org ' 
Subject: RE: stds-80220-requirements: Shall-Will-Should in 802.20
Requirem ents v5 - C802.20-03-6921 
 
Hello, 
Here is a link that might be useful for the discussion
http://standards.ieee.org/guides/style/section5.html
<http://standards.ieee.org/guides/style/section5.html>  
Vladimir 
-----Original Message----- 
From: Joanne Wilson 
To: Joseph Cleveland; stds-80220-requirements@ieee.org 
Sent: 7/23/2003 1:01 AM 
Subject: RE: stds-80220-requirements: Shall-Will-Should in 802.20
Requirements v5 - C802.20-03-6921 
Hi! 
I propose the following modification to Joseph's terminology: 
2a.  "Should" expresses a provision that is recommended, but is not
mandatory 
2b.  "May" expresses a provision that is allowed, but is not mandatory 
Best regards, 
Joanne Wilson 
ArrayComm, Inc 
+1 202 669-4006  Direct 
+1 253 484-0330  Fax 
joanne@arraycomm.com 
 
-----Original Message----- 
From: owner-stds-80220-requirements@majordomo.ieee.org 
[ mailto:owner-stds-80220-requirements@majordomo.ieee.org
<mailto:owner-stds-80220-requirements@majordomo.ieee.org> ]On Behalf Of
Joseph Cleveland 
Sent: Tuesday, July 22, 2003 5:00 PM 
To: 'stds-80220-requirements@ieee.org' 
Subject: stds-80220-requirements: Shall-Will-Should in 802.20
Requirements v5 - C802.20-03-6921 
 
Hi All: 
I recommend the following wording for "shall", "will", should", etc. for
inclusion in 802.20 Requirements document: 
The following terminology identifies the designation of mandatory versus
non-mandatory requirements: 
 
1.      "shall" expresses a provision that is binding 
2.      "should" and "may" expresses non-mandatory provisions 
3.      "will" expresses a declaration of purpose.  It may be necessary 
to use "will" in cases where the simple future tense is required 
 
Joseph Cleveland 
Director, Systems & Standards 
Wireless Systems Lab 
Samsung Telecommunications America 
Richardson, TX 75081 
(O) 972-761-7981  (M) 214-336-8446  (F) 972-761-7909 
 
This mail passed through mail.alvarion.com 
************************************************************************

************ 
This footnote confirms that this email message has been scanned by
PineApp Mail-SeCure for the presence of malicious code, vandals &
computer viruses.
************************************************************************

************ 
This mail was sent via mail.alvarion.com 
************************************************************************
************ 
This footnote confirms that this email message has been scanned by
PineApp Mail-SeCure for the presence of malicious code, vandals &
computer viruses.
************************************************************************
************ 


This mail passed through mail.alvarion.com

************************************************************************
************
This footnote confirms that this email message has been scanned by
PineApp Mail-SeCure for the presence of malicious code, vandals &
computer viruses.
************************************************************************
************

This mail was sent via mail.alvarion.com
 
************************************************************************************
This footnote confirms that this email message has been scanned by
PineApp Mail-SeCure for the presence of malicious code, vandals & computer viruses.
************************************************************************************