I've observed that the new InfoCenter format seems to enjoy a higher
velocity of updates, corrections, and amplifications. If you look at the
WebSphere Application Server for z/OS InfoCenter, for example, there are
date stamps on certain pages within the past month. The InfoCenter format
has been
Walt Farrell said:
A DOC APAR would help in the interim, imho, but the OP doesn't seem to
agree.
I absolutely disagree. There's no seem to it.
How often do you research DOC APARS for your manuals?
Here's an example: Suppose you can't remember which register holds the
remainder on a divide
Or, just use the IBM copy and don't keep your own.
There is an old joke regarding the circular arguments about documentation:
Caller: The example on page 666 is incorrect.
IBM: So what? It's only an example.
Caller: How do I ... ?
IBM: Use the example on page 666.
Bad documentation hurts
Does anyone know why IBM refuses to update their documentation any more?
Once documentation is shipped, it is never supported. I have had this problem
several times in the past few years. The software is not working as
documented, but the support center determines the doc is wrong, not the
warrant it, they open
a DOC or informational apar on it.
- Original Message -
From: Martin Kline [EMAIL PROTECTED]
Newsgroups: bit.listserv.ibm-main
To: IBM-MAIN@BAMA.UA.EDU
Sent: Tuesday, April 29, 2008 10:12 AM
Subject: Supported Documentation
Does anyone know why IBM refuses
But the next update to the manual doesn't occur until the release currently
under development or later. Even IBM's online doc doesn't get updated for
currently supported releases.
I've sent them updates on a few documentation issues that need to be
corrected, and lo and behold, they have
-Original Message-
From: IBM Mainframe Discussion List [mailto:[EMAIL PROTECTED] On
Behalf Of Martin Kline
Sent: Tuesday, April 29, 2008 9:13 AM
To: IBM-MAIN@BAMA.UA.EDU
Subject: Supported Documentation
Does anyone know why IBM refuses to update their documentation any more?
Once
On Tue, 29 Apr 2008 09:12:53 -0500, Martin Kline [EMAIL PROTECTED] wrote:
They tell me they will put in an untrackable request to update the
documentation in a future release.
Alternatively, you can send in the request yourself (check the book for
suggestions on how to send in reader's
Does anyone know why IBM refuses to update their documentation any
more?
When I were a lad (back in the day) IBM used to mail out Technical News
Letters (TNLs) on real dead-tree PAPER (gasp!) that you could insert in
the proper place in your 3 ring binder PAPER copy of each manual. Those
changes
On Tue, 29 Apr 2008 12:29:29 -0400, Craddock, Chris wrote:
When I were a lad (back in the day) IBM used to mail out Technical News
Letters (TNLs) on real dead-tree PAPER (gasp!) that you could insert in
the proper place in your 3 ring binder PAPER copy of each manual. Those
changes could occur
When I were a lad (back in the day) IBM used to mail out Technical News
Letters (TNLs) on real dead-tree PAPER (gasp!) that you could insert in
the proper place in your 3 ring binder PAPER copy of each manual. Those
changes could occur anywhere in the lifecycle of a product release.
And we Liked
On Tue, 29 Apr 2008 11:14:18 -0500, Walt Farrell wrote:
On Tue, 29 Apr 2008 09:12:53 -0500, Martin Kline wrote:
They tell me they will put in an untrackable request to update the
documentation in a future release.
Alternatively, you can send in the request yourself (check the book for
Gil wrote:
And what help is that to the submitter's peers who are apt to encounter
the same problem?
That's exactly why updated doc should be made available.
--
For IBM-MAIN subscribe / signoff / archive access instructions,
Having read the thread (so far), I have a few comments. (All of this is
written assuming that what you want is semi-real-time updates to electronic
versions of IBM documentation).
1) Even in the days of hard-copy TNL's, each TNL was reflected in a new
dash-level. Do you REALLY want a new
On Tue, 29 Apr 2008 11:58:24 -0500, Paul Gilmartin [EMAIL PROTECTED] wrote:
On Tue, 29 Apr 2008 11:14:18 -0500, Walt Farrell wrote:
On Tue, 29 Apr 2008 09:12:53 -0500, Martin Kline wrote:
They tell me they will put in an untrackable request to update the
documentation in a future release.
A DOC APAR would help in the interim, imho, but the OP doesn't seem to
agree.
--
Walt Farrell, CISSP
IBM STSM, z/OS Security Design
FWIW,
I agree with the OP on DOC APARs. I've had many open for years and had to
keep banging on IBM to get them incorporated into the manuals. RCF's work
16 matches
Mail list logo