atw: Re: Ah well it's Friday. What bugs me is....


> -----Original Message-----
> From: austechwriter-bounce@xxxxxxxxxxxxx [mailto:austechwriter-
> bounce@xxxxxxxxxxxxx] On Behalf Of Peter G. Martin
> Sent: Friday, 26 May 2006 3:38 PM
> To: austechwriter@xxxxxxxxxxxxx
> Subject: atw: Ah well it's Friday. What bugs me is....
> 
> Some of the effects of programming languages on everyday language bug me
> from time to time.
> 
> For example, I need a new document filter to process stuff from software
> developers when they start talking about conditional applications of ...
> well, things....
> 
> You know you're dealing with programmers when you see someone keep using
> "functionality" as though it's a real word, but.....
> 
> Ever noticed, though, that when you see an IF, it's invariably followed by
> "THEN" as a form of punctuation ?
> 

;-) this covers issues of precision. For example if you write a manual
covering APIs where that document is also for BAs then if you write:

Void SomeFunction(parameters)

The BA will ask why put the void there if the function returns nothing? To
them there is no need. Remove it and the programmers will get 'tense' due to
this removal reflecting a lack in precision.

BAs need it 'vague', flexible, programmers need it 'crisp', 'rigid'. - it
comes down to issues of precision.

Chris.


**************************************************
To post a message to austechwriter, send the message to 
austechwriter@xxxxxxxxxxxxxx

To subscribe to austechwriter, send a message to 
austechwriter-request@xxxxxxxxxxxxx with "subscribe" in the Subject field.

To unsubscribe, send a message to austechwriter-request@xxxxxxxxxxxxx with 
"unsubscribe" in the Subject field.

To search the austechwriter archives, go to 
www.freelists.org/archives/austechwriter

To contact the list administrator, send a message to 
austechwriter-admins@xxxxxxxxxxxxx
**************************************************

Other related posts: