Each manual has both a comment form you can print then mail and an email 
address where you can send comments. In my experience, some component 
owners are hard to accept criticism or do some extra work. Some respond 
quickly, others may take months to respond, as fixing documentation is not a 
high priority. Often they will not fix the problem in the release of the manual 
you saw the problem, but the next release they are already working on. I have 
pointed out some very simple mistakes and heard they needed to check with 
the developer.

But if you send it to IBM directly you will get better results then posting it 
here and hoping an IBMer will stumble upon it and make a change. I also 
cut&paste their paragraph from the manual, explain where my confusion is, 
and offer an alternate wording. They are not obligated to use your version, 
but I find the more intelligent component owners will do some work to make 
the manuals better.

Not naming names, one group got back to me in days, one group is often 3 
months. But they do get back to me. By then, I've forgotten what I sent. I 
complained about the disconnect between a program directory and the web 
site they sent me to. And how long it then takes to find the poorly named 
manuals, where titles have no part of the name of the product as shown n the 
program directory. I got back it only took them five minutes to find it. 
Sarcastically I pointed out they must feel wonderful that a group famliar wiht 
the products and names needed five minutes, when I could put the publication 
name in the search box on the home page age find it in less than a minute. 
They are working on getting the program directory, website, and manual 
names to have better consistency. It might be two releases from what I just 
installed, but they hear you if you send it to them.


On Thu, 3 Jan 2008 14:57:36 -0600, Patrick O'Keefe 
<[EMAIL PROTECTED]> wrote:

>On Thu, 3 Jan 2008 12:23:57 -0800, John Mattson
><[EMAIL PROTECTED]> wrote:
>
>>...
>>    I would like to request the following FIXes to Doc AND Message
>>1) Make the DOC read
>>>>>

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [EMAIL PROTECTED] with the message: GET IBM-MAIN INFO
Search the archives at http://bama.ua.edu/archives/ibm-main.html

Reply via email to