Cobol - Re: RW on Working-Storage (was: J4 - presentation/discussion on "Future of the

Author

Re: RW on Working-Storage (was: J4 - presentation/discussion on "Future of the

Robert

2008-03-15, 3:56 am

On Sat, 15 Mar 2008 04:25:14 GMT, "William M. Klein" <wmklein@nospam.netcom.com> wrote:

>Actually, ISO (ITTF specifically) is very careful about the use of "NOTE". By
>definition, in an ISO Standard anything included in a "NOTE" (or an example) is
>"non-normative". Therefore, the point of that NOTE is "informative" and is
>simply confirming the fact that there is NO normative text telling implementers
>what they are required to do with storage when a CANCEL occurs.
>
>If you are interested in the ISO drafting rules, I think I can find an online
>reference for you. (It deals with things like "notes"; use of "can" "may"
>"shall" "will" etc)

Thanks for the kind offer, but I decline. If I were writing a standard, I'd strive for
plain English and try to avoid talking like a lawyer or a programmer.

Last w

I wrote a Business Requirement document that deliberately avoided industry
jargon. I wrote it in such plain language that anyone could understand it. My colleagues
thought it unprofessional. One of them rewrote it in dense techie-speak.

I find it

that clear writing is considered unprofessional.

Sponsored Links