OT: Syntax for if/then statement
Tammy.VanBoening at jeppesen.com
Tammy.VanBoening at jeppesen.com
Thu Jun 29 10:22:20 PDT 2006
All,
I am hoping the fellow writers on this list can provide some information
for this request. Another writer here at Jeppesen and I have always used
the following syntax for a conditional/causal statement: If <blah, blah>,
then <blah, blah>. We have a new editor that just joined who is in the
process of defining our styles and standards. Obviously, everyone has an
opinion about what is "right" and what is "wrong" in editing . . .in many
cases, it's so subjective. That said, when we have our editorial meetings
about defining our styles and standards, you need to be prepared with some
factual support for a certain type of style or standard - not just the
emotional "because we've always done it this way." Years ago, I had such a
reference for writing if/then statements this way - I don't remember which
manual I referenced. Our new editor wants to add the word "and" to such
statements - if <blah, blah>, AND then <blah, blah>. Both I and the other
writer disagree with the editor on this one - it should be just if/then -
no "and." I have tried for the life of me to find a documentation
reference that would support this syntax (something like Sun's Read Me
First guide, etc), and although I know I had one in the past, I can't find
it now. Googling only leads me to programming references - the thin thread
here would be since we are writing software documentation, if/then, would
make sense, since that's where the if/then statement syntax was
developed, but. . . .
Any and all references/advice would be much appreciated.
TIA,
TVB
Tammy Van Boening
Senior Technical Writer
Jeppesen Sanderson, Inc.
303-328-4420
tammy.vanboening at jeppesen.com
More information about the framers
mailing list