SCOUG-Programming Mailing List Archives
Return to [ 15 | 
February | 
2004 ]
<< Previous Message << 
 >> Next Message >>
 
 
 
Content Type:   text/plain 
"...It wasn't a class, Lynn.  It was one of the IBM books.  Since   
IBM was heavily pushing PL/I at the time, they used their best   
people as writers. ..."  
 
Wrong.  Apparently you are absolutely unaware of how IBM   
picks writers for their manuals, especially their red books.    
Having been selected at one time to write a general   
information manual on an about-to-be-announced version of   
UNIX on an IBM mainframe and working intensely with others   
who only function was manual writing for IBM I can speak to   
this with some authority.  
 
I was selected because I knew something about it, enough to   
know I didn't like it.  Nevertheless my job was to put as   
positive a spin on it as possible, which I did.  So well in fact   
that others knowing my distaste for all things UNIX   
complimented me by saying that from my writing they would   
never have guessed my true feelings.  
 
I once came close to another opportunity based on my having   
successfully sold and installed the entire Western Region's   
quota of the IBM Data Dictionary.  It was a $50,000 toss up   
between essentially writing about how I used its features to   
successfully produce its value to the clients and producing a   
manual on naming conventions.  The naming conventions won.  
 
Perhaps the worst instance of author selection was allowing   
the "inventors" of IBM's HIPO documentation method, which   
became an anchor on any accounts neck who attempted to   
use it, to write a manual on it.  They didn't understand what   
they were doing or why they were doing it.  
 
That sits right up there with the folks in IBM Research Center   
in Yorktown who wanted to write an APL compiler using   
Fortran.  
 
You got me started unfortunately, Peter, with this begin-end   
thing.  Don't get me started on IBM manuals.  
 
=====================================================  
 
To unsubscribe from this list, send an email message  
to "steward@scoug.com". In the body of the message,  
put the command "unsubscribe scoug-programming".  
 
For problems, contact the list owner at  
"rollin@scoug.com".  
 
=====================================================  
 
  
<< Previous Message << 
 >> Next Message >>
Return to [ 15 | 
February | 
2004 ] 
  
  
The Southern California OS/2 User Group
 P.O. Box 26904
 Santa Ana, CA  92799-6904, USA
Copyright 2001 the Southern California OS/2 User Group.  ALL RIGHTS 
RESERVED. 
 
SCOUG, Warp Expo West, and Warpfest are trademarks of the Southern California OS/2 User Group.
OS/2, Workplace Shell, and IBM are registered trademarks of International 
Business Machines Corporation.
All other trademarks remain the property of their respective owners.
 
  |