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.
|