On 2017-02-18, at 09:03, Allan Staller wrote:
> Refrain: the "new tools" are neither as reliable, available, accessible, or
> functional as the items they are replacing!
>
> p>
> Re: your complaint of the day, I did some investigation. We moved the HLASM
> documentation out of the z/OS V2R2 KC and now instead point to the HLASM KC
> (https://www.ibm.com/support/knowledgecenter/SSENW6). This is to prevent
> duplication, etc. However, while evidence of the HLASM documentation was
> removed from the z/OS V2R2 KC TOC, it seems that the topics themselves are
> still floating around in our KC.
>
> All I can say is: ignore them until they're properly removed. For current
> HLASM documentation, instead go to the HLASM KC. I'm sorry that this means
> that the release drop-down that you like so much is useless in this case, but
> at least you can successfully enjoy it with most other elements!
> </snip>
>
Conway's Law: http://www.melconway.com/Home/Conways_Law.html
Any organization that designs a system (defined broadly)
will produce a design whose structure is a copy of the
organization's communication structure.
It's laudable that HLASM is maintained uniformly across all supported
platforms, apparently from a single source.
It's deplorable that something as intrinsic to z/OS operations will
no longer be cited in the z/OS documentation. A link to the HLASM
root ToC should continue to appear as an item in the z/OS ToC. There's
a failure to communicate here.
(I could open the URL above with Mail.app, but not with Firefox until
I manually removed the final ")". Firefox is not to blame. ")" is
a valid character within URLs and ought not be used to delimit URLs.
Appendix C. Delimiting a URI in Context
...
In practice, URIs are delimited in a variety of ways, but usually
within double-quotes "http://example.com/";, angle brackets
<http://example.com/>, or just by using whitespace:
...
Using <> angle brackets around each URI is especially recommended as
a delimiting style for a reference that contains embedded whitespace.
<https://tools.ietf.org/html/rfc3986#appendix-C> )
-- gil
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: INFO IBM-MAIN
