Re: New look and linking for V2.3 product documentation PDFs

[Seymour J Metz]

The right answer to the wrong question. If you read the reference you cited, 
you will note that "MATHML" can refer to either 
https://en.wikipedia.org/wiki/MathML#Presentation_MathML or to 
https://en.wikipedia.org/wiki/MathML#Content_MathML.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List  on behalf of 
Pew, Curtis G 
Sent: Friday, March 15, 2019 2:58 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: New look and linking for V2.3 product documentation PDFs

On Mar 15, 2019, at 11:27 AM, Seymour J Metz 
mailto:sme...@gmu.edu>> wrote:

That raises one of my standard question templates: what do they mean by 
"MATHML"? Usually the answer to such question is "The minimum we can get away 
with", but one can always hope.


https://secure-web.cisco.com/1yjGPzXyoL9FyCuqh25vKPXrqNf59Fsy_kzSs_-IB3aWdj9Z-6NGvvbyQOqbhy19OSZiPLZMb25_HpUt2ZKYbmpsDPbKsQJUHd-P5wEWnGFyCjDl-AFX6CD3iqBC28_Dt6Gr92grR5vxf43UfC2Ta1SBz0r9L5-gsg_y4bY9TNoFHZOpoo1n7N1c79YUejV1zydSJH3zqQSwNYpSUGwZFgfPVO-Z2tyFFImcciqwo07xzov-ONUtmmYqcYYvHr0uNOMmm6Rfmiv2F5NIaKMT5ZH12BdJHYOGBJi_b2D4rt3VUICTcd_qGFgPO1pSWuHuuilqc2WvUyxiouuCHXysbknxwKvFJXWLTdB6oFkauMqywWFAHQ3HBXJcOvwUouPUcu8o4FyRRWO9Ah283O-rdx5BmhgowVsSYt8pk5iP4xbJ3-6_O0cUqiGMK10NhGvla/https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FMathML
 maybe?


--
Pew, Curtis G
curtis@austin.utexas.edu<mailto:curtis@austin.utexas.edu>






--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Pew, Curtis G]

On Mar 15, 2019, at 11:27 AM, Seymour J Metz 
mailto:sme...@gmu.edu>> wrote:

That raises one of my standard question templates: what do they mean by 
"MATHML"? Usually the answer to such question is "The minimum we can get away 
with", but one can always hope.


https://en.wikipedia.org/wiki/MathML maybe?


--
Pew, Curtis G
curtis@austin.utexas.edu






--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Susan Shumway]

Thanks, Wendell! FWIW, this thread is simply full of constructive 
feedback that I actually always love receiving. I haven't felt beaten 
upon on here in at least a few years. ;-) Even if I do again at some 
point, I'll know that it stems from frustration with one of our outputs 
and therefore identifies room for content improvement.


I'm glad to hear that you like the new PDFs. After I got used to them, I 
think even I prefer the new style over the old one. We just apparently 
need to rework some specific pieces of source to ensure that it all 
renders well, and the feedback in this thread has been fantastic for 
pinpointing those instances.


-Sue Shumway


On 3/15/2019 10:27 AM, Wendell Lovewell wrote:

Hi Sue,

I know we've beaten on you pretty badly here.  So now that I've had time to use 
some of them, I thought I'd say that I really like the look of the new PDFs.  
You can't please all the people all the time, and you could never please all of 
us any of the time!   Thanks for working so diligently to improve them.

Best regards,
Wendell Lovewell

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN



--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Seymour J Metz]

That raises one of my standard question templates: what do they mean by 
"MATHML"? Usually the answer to such question is "The minimum we can get away 
with", but one can always hope.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List  on behalf of 
Paul Gilmartin <000433f07816-dmarc-requ...@listserv.ua.edu>
Sent: Thursday, March 14, 2019 7:06 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: New look and linking for V2.3 product documentation PDFs

On Mon, 4 Mar 2019 21:35:31 +, Seymour J Metz wrote:

>... (I want Bookie back!)
>
Interesting that the pdfinfo tells me:
Antenna House PDF Output Library 6.5.1119 (Linux64)
... and:

https://secure-web.cisco.com/1lp7CwE25DnCEBgDiU1n4CN9LwIvKrotYAhLhtiCfkl2UxsR0ln5TEYafPVLZpVvVa_6c0E_qaWUds4V4ULSLVUvkDwLmkl82MCYC-gxi8ZhQa84mBu0EVv5BcIa9Qdd2VWv3F6ikkgQfjW5dAEaoSpSxlkBjZ9_5nm-4GhdByoSScnO0ODFiGEqCbIE-yCwz_dd7uE_Du3hhBcG1Sy30b4SFv9aSuGlsDS_cDsFthV5KE1Y9u4Zo3epUuTJoZ3SevqxLx9IUgfoWhvzbmwiy2Q390q1DDBlWl1Gw2AvzGcqJCN-g58HUpIgCyHfOVV-JBXP3jKzp7yCGx0gRMIrCKcxve0bAnSTuRjMvQz68pywP6QT4NXhDgmpbreyRC1Pr63j2EaubbTD5YPCyP9xRtZ0ViiD_G8pCUy_GIqlCI1neattsMs44yktMeMeXyZsj/https%3A%2F%2Fwww.antennahouse.com%2F
... suggests that they were converted from something else.  Word?  Bookie?  ...?

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Mike Shaw]

On 3/14/2019 10:18 PM, Paul Gilmartin wrote:

On Thu, 14 Mar 2019 21:40:18 -0400, Mike Shaw at QUICKREF wrote:

> 

QUICKREF, too?

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN



No Gil, we convert everything from PDF or HTML to text and then store it 
in our DB.


Mike Shaw
MVS/QuickRef Support Group
Chicago-Soft, Ltd

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Wendell Lovewell]

Hi Sue, 

I know we've beaten on you pretty badly here.  So now that I've had time to use 
some of them, I thought I'd say that I really like the look of the new PDFs.  
You can't please all the people all the time, and you could never please all of 
us any of the time!   Thanks for working so diligently to improve them.

Best regards,
Wendell Lovewell

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Thu, 14 Mar 2019 21:40:18 -0400, Mike Shaw at QUICKREF wrote:

>On 3/14/2019 7:07 PM, Paul Gilmartin wrote:
>> On Mon, 4 Mar 2019 21:35:31 +, Seymour J Metz wrote:
>>
>>> ... (I want Bookie back!)
>>>
>> Interesting that the pdfinfo tells me:
>>  Antenna House PDF Output Library 6.5.1119 (Linux64)
>> ... and:
>>  https://www.antennahouse.com/
>> ... suggests that they were converted from something else.  Word?  Bookie?  
>> ...?
>
>I think IBM keeps a lot of doc internally in DITA format:
>
>  https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
>
>and then uses tooling to export it from DITA markup to HTML or PDF.
> 
(more: https://www.antennahouse.com/dita-editor/ )

QUICKREF, too?

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Mike Shaw]

On 3/14/2019 7:07 PM, Paul Gilmartin wrote:

On Mon, 4 Mar 2019 21:35:31 +, Seymour J Metz wrote:


... (I want Bookie back!)


Interesting that the pdfinfo tells me:
 Antenna House PDF Output Library 6.5.1119 (Linux64)
... and:
 https://www.antennahouse.com/
... suggests that they were converted from something else.  Word?  Bookie?  ...?

-- gil



I think IBM keeps a lot of doc internally in DITA format:

 https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture

and then uses tooling to export it from DITA markup to HTML or PDF.

Mike Shaw
MVS/QuickRef Support Group
Chicago-Soft, Ltd.

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Mon, 4 Mar 2019 21:35:31 +, Seymour J Metz wrote:

>... (I want Bookie back!)
> 
Interesting that the pdfinfo tells me:
Antenna House PDF Output Library 6.5.1119 (Linux64)
... and:
https://www.antennahouse.com/
... suggests that they were converted from something else.  Word?  Bookie?  ...?

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Carmen Vitullo]

Sue, we use to be able to report broken links, doc not found for the KC site, 
now I cannot; 


The requested resource is not found: 
/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.e0zl100/toc.htm 




Carmen Vitullo 

- Original Message -

From: "Susan Shumway"  
To: IBM-MAIN@LISTSERV.UA.EDU 
Sent: Friday, March 1, 2019 1:50:27 PM 
Subject: Re: New look and linking for V2.3 product documentation PDFs 

Thank you all for the feedback and suggestions! I've collected it all 
and will work with the team to sort out items that aren't already on our 
radar and add them to our list of potential improvements. I can tell 
right now that some items are within our control and some unfortunately 
aren't, but we'll do our best to implement as many as possible. 

For a little background on the new look of the PDFs, we were instructed 
to move to new build tooling, and the new PDF visual style just came 
along with it. Our team worked hard over the past months to prepare our 
z/OS content source for the drastic under-the-covers changes, but 
there's still work to do on the source and, if deemed necessary and 
possible via requirements or such, on the tooling. Rest assured that 
we'll continue working to make the PDFs as usable as possible for you all! 

In response to the comments about PDF file names, you REALLY don't want 
to rename the PDFs. Most importantly, doing so breaks all cross-book 
links. Instead, as suggested by others here, use the index.html file. To 
do so, go to the PDF download page ( 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
), select "Download all z/OS V2R3 Library publications to ZIP file," 
extract the whole thing into the suggested directory structure, open the 
included index.html file, and click the links to open the downloaded 
local versions of the PDFs. Alternatively, on the PDF download page, you 
can just click "Show all PDF files" and then search for a cryptic 
(though sans any spaces or weird characters!) file name or title or 
order number to quickly map it to the other information about a PDF. 
I've even been known to do this myself in a pinch. 

Also, Gil asked about "zOS_V2R3_Documentation.pdx". That's very much 
still around - it's the search file for the Acrobat Indexed PDF 
collection. We'll have a fresh V2R3 collection that contains all these 
new DCS PDFs posted within the next few days. If you bookmark and always 
start at the z/OS Internet Library ( 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
), you'll always see all the different options for product 
documentation, other content, related helpful tools, etc. 

We really appreciate this feedback, so please keep it coming. (The best 
way to do so is through the "Feedback" link on KC: 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3/en/homepage.html
 
. It's then formally tracked and you get updates on progress.) As 
always, feel free to drop me a direct note if you have a question and 
I'll try to help. 

-Sue Shumway 

-- 
Sue Shumway 
z/OS Product Documentation Lead 
IBM Poughkeepsie 
chale...@us.ibm.com 


On 2/28/2019 9:54 PM, Paul Gilmartin wrote: 
> On Wed, 27 Feb 2019 21:00:57 -0600, Susan Shumway wrote: 
>> 
>> I want to make you aware that every PDF in the z/OS V2.3 library was just 
>> refreshed to update the visual style and link coding. Because of the link 
>> coding changes, clicking on a link in an old-style PDF to a new style PDF 
>> will not work, and vice versa. So, to ensure that all cross-book links 
>> continue to work for you, ensure that you download the entire fresh set of 
>> library PDFs from 
>> https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
>> as soon as you get the chance. 
>> 
> Now I'm trying it. Seems pretty good. 
> 
> It would be nice if the web metadata included file size so I could eagerly 
> watch the progress bar during download. 
> 
> Is the "zOS_V2R3_Documentation.pdx" index gone? I sometimes found it useful. 
> 
> It would sure be nice if the cross-document references pointed to a chapter, 
> not 
> just to the title page of the referenced document. I suspect that's not easy 
> to do. 
> 
> 
> On Thu, 28 Feb 2019 13:52:20 +, Allan Staller wrote: 
> 
>> Ref: 
>> https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library
>>  
>> 
>> I observed one thing.hThe introductory "new style" screens are portrait 
>> oriented and take up a lot of vertical real estate. 
>> The new screens generate a lot of unnecessary scrolling. 
>> 
>> I have a laptop and a desktop, both with landscape oriented monitors. 
>> The only portrait oriented device I have is a cell phone. 
>> 
> For that it would be n

Re: New look and linking for V2.3 product documentation PDFs

[Seymour J Metz]

Well, if bad documentation is the issue, why is windoze still here?


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List  on behalf of 
Bill Ogden 
Sent: Tuesday, March 5, 2019 10:09 AM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: New look and linking for V2.3 product documentation PDFs

>When learning a complex new concept, a hardcopy manual where you can
>stick a finger in a page, flip backwards, view multiple pages at once,
>refer to another chapter etc. is much easier than softcopy. Is it
>surprising that a 1000 page manual contains information that softcopy
>users never see?

50 years from now, when Ph.D. students are writing dissertations on "Why
the mainframe disappeared" I suspect they will narrow the search to two
very basic, interrelated issues:

1. Lack of a hands-on hobby version, and
2. Lack of good study documentation.

On-line manuals are great for looking up an isolated fact; IMHO, they
leave much to be desired for serious study.

Bill Ogden


--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tom Brennan]

Things like the ABC's of System Programming are really good.  But 
without #1, they aren't much help to someone interested.


On 3/5/2019 7:09 AM, Bill Ogden wrote:

When learning a complex new concept, a hardcopy manual where you can
stick a finger in a page, flip backwards, view multiple pages at once,
refer to another chapter etc. is much easier than softcopy. Is it
surprising that a 1000 page manual contains information that softcopy
users never see?


50 years from now, when Ph.D. students are writing dissertations on "Why
the mainframe disappeared" I suspect they will narrow the search to two
very basic, interrelated issues:

1. Lack of a hands-on hobby version, and
2. Lack of good study documentation.

On-line manuals are great for looking up an isolated fact; IMHO, they
leave much to be desired for serious study.

Bill Ogden


--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN




--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Bill Ogden]

>When learning a complex new concept, a hardcopy manual where you can
>stick a finger in a page, flip backwards, view multiple pages at once,
>refer to another chapter etc. is much easier than softcopy. Is it
>surprising that a 1000 page manual contains information that softcopy
>users never see?

50 years from now, when Ph.D. students are writing dissertations on "Why 
the mainframe disappeared" I suspect they will narrow the search to two 
very basic, interrelated issues:

1. Lack of a hands-on hobby version, and
2. Lack of good study documentation.

On-line manuals are great for looking up an isolated fact; IMHO, they 
leave much to be desired for serious study.

Bill Ogden 


--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Martin Packer]

As you mentioned dead trees, my first large-sale publication (which I
turned into a Redbook in 1992 and updated in 1997) was called DEADTREE
SCRIPT/LIST3820 for quite a few years. :-)

(I’m still typecast as “Batch Performance” in the eyes of some people.) :-)

Cheers, Martin

Sent from my iPad

> On 4 Mar 2019, at 21:35, Seymour J Metz  wrote:
>
> Well, I certainly started with dead trees, and I occasionally have cause
to use them, but generally I am more production with a machine readable
version (I want Bookie back!)
>
>
> --
> Shmuel (Seymour J.) Metz
>
https://urldefense.proofpoint.com/v2/url?u=http-3A__mason.gmu.edu_-7Esmetz3=DwIFAw=jf_iaSHvJObTbx-siA1ZOg=BsPGKdq7-Vl8MW2-WOWZjlZ0NwmcFSpQCLphNznBSDQ=xpGIqqWsJkKhndS1klPpLI1cfJ0QERU1re96ore_h_0=rGSCbQKyze8jTvWjtnioHloHqV63fxoFma4W0teDVC4=

>
> 
> From: IBM Mainframe Discussion List  on behalf
of Andrew Rowley 
> Sent: Friday, March 1, 2019 6:10 PM
> To: IBM-MAIN@LISTSERV.UA.EDU
> Subject: Re: New look and linking for V2.3 product documentation PDFs
>
>> On 2/03/2019 4:55 am, Seymour J Metz wrote:
>> I can see making copies for laptops off of the Internet, but dead tree?
I wish I didn't believe you.
>>
> You can tell the people who learned from printed manuals from those who
> use only softcopy ones - the people who learned from softcopy ask "How
> do I do..." and the people who learned from hardcopy answer them.
> (Mostly joking!)
>
> I suspect most of us on this list are old enough to have started in
> mainframe with hardcopy manuals. We may not appreciate how difficult it
> is to learn z/OS without them.
>
> When learning a complex new concept, a hardcopy manual where you can
> stick a finger in a page, flip backwards, view multiple pages at once,
> refer to another chapter etc. is much easier than softcopy. Is it
> surprising that a 1000 page manual contains information that softcopy
> users never see?
>
> There's a couple of manuals I print in full, more often I will print a
> chapter or 2. Even then the majority of time I use softcopy, but
> occasionally when it's a complex topic and my brain starts to strain I
> pull out the hardcopy. I almost always learn something new as I flip
> through to the correct chapter.
>
> I could postulate that the technologies that have met with most
> resistance on the mainframe (e.g. z/OS Unix, Java) are those that came
> along after the switch to softcopy manuals, so people never had the
> opportunity to read and learn from hardcopy.
>
>
> Andrew Rowley
>
> --
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>
> --
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU


--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Seymour J Metz]

Well, I certainly started with dead trees, and I occasionally have cause to use 
them, but generally I am more production with a machine readable version (I 
want Bookie back!)


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List  on behalf of 
Andrew Rowley 
Sent: Friday, March 1, 2019 6:10 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: New look and linking for V2.3 product documentation PDFs

On 2/03/2019 4:55 am, Seymour J Metz wrote:
> I can see making copies for laptops off of the Internet, but dead tree? I 
> wish I didn't believe you.
>
You can tell the people who learned from printed manuals from those who
use only softcopy ones - the people who learned from softcopy ask "How
do I do..." and the people who learned from hardcopy answer them.
(Mostly joking!)

I suspect most of us on this list are old enough to have started in
mainframe with hardcopy manuals. We may not appreciate how difficult it
is to learn z/OS without them.

When learning a complex new concept, a hardcopy manual where you can
stick a finger in a page, flip backwards, view multiple pages at once,
refer to another chapter etc. is much easier than softcopy. Is it
surprising that a 1000 page manual contains information that softcopy
users never see?

There's a couple of manuals I print in full, more often I will print a
chapter or 2. Even then the majority of time I use softcopy, but
occasionally when it's a complex topic and my brain starts to strain I
pull out the hardcopy. I almost always learn something new as I flip
through to the correct chapter.

I could postulate that the technologies that have met with most
resistance on the mainframe (e.g. z/OS Unix, Java) are those that came
along after the switch to softcopy manuals, so people never had the
opportunity to read and learn from hardcopy.


Andrew Rowley

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tony Harminc]

On Sat, 2 Mar 2019 at 01:14, Paul Gilmartin
<000433f07816-dmarc-requ...@listserv.ua.edu> wrote:

> Most of the links in:
> asmr1023.pdfSC26-4940-08HLASM Language Reference
> Bibliography
>
> ... don't work for me, or they try to downoad from IBM's server
> when the docs should be available from the extracted .zip.

The ones that don't work for me in that book seem to have an
extraneous dot in them, e.g.
F:\Books\zOS23Feb2019\.\asmtug23.html

As to pointing to the IBM site, I've noticed this only for the refs to
the zArch Principles of Operation and the Reference Summary, which are
legitimately not z/OS books, even if they're listed on the contents
page. Even the links in the index.html file point to IBM for those
two. I fixed my index locally, but it would be nice if IBM could
produce an index that assumes you've downloaded them along with the
z/OS books. Or even provide them as part of the package.

Tony H.

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tom Marchant]

On Fri, 1 Mar 2019 17:55:59 +, Seymour J Metz wrote:

>I can see making copies for laptops off of the Internet, but dead tree? I wish 
>I didn't believe you.

There is one manual that I use nearly every day, and I routinely print it when 
a new one is released. 
That is the z/Architecture Reference Summary.

I use the Principles of operation nearly as often, and I keep the PDF of latest 
edition open.

-- 
Tom Marchant

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Kirk Wolf]

For me, organizing into directories isn't that useful:  my pattern is to
open the directory in nautilus and then type a word like "unix" and then I
see all of the documents with Unix in the title.
And it would also break inter-document links, which I find useful.

On Sat, Mar 2, 2019 at 12:21 PM Paul Gilmartin <
000433f07816-dmarc-requ...@listserv.ua.edu> wrote:

> On Sat, 2 Mar 2019 10:05:26 -0600, Kirk Wolf wrote:
>
> >I use linux and for many years I have organized the IBM z/OS PDFs by
> making
> >symlinks to the actual file name where the symlink name is the actual
> title
> >of the PDF.
> >That way, you can easily search for the title (symlink) to find a book,
> but
> >the inter-book links work.
> >
> >Here's the script that I use to set everything up.   I just tried it with
> >the latest zip download of pdfs and it works fine - the inter-document
> >links work just fine, like before.
> >
> >#!/bin/sh
> ># Make symlinks to all .pdf files in the current directory to names that
> >match their Title:
> >ls -1 *.pdf | while read f
> >do
> >  echo "Examining: "$f
> >  title=$(pdfinfo "$f" | grep "Title:" | cut -c17- | tr -d '/\\:' | tr ' '
> >'_')
> >  if test -n "$title" -a ! -s "$title.pdf" ; then
> >echo "link $title.pdf -> $f"
> >ln -s "$f" "$title.pdf"
> >  fi
> >done
> >
> Ah!  Yours is 1/5 the size of mine.  But I met the wish of @sas "to
> organize the manuals [symlinks] into directories, according to the
> layout on the index.html."  Parsing PITA.
>
> -- gil
>
> --
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tom Marchant]

On Fri, 1 Mar 2019 14:50:27 -0500, Susan Shumway wrote:

>In response to the comments about PDF file names, you REALLY don't want
>to rename the PDFs.

I think that the metadata for a PDF includes something called document title, 
and that the title can be displayed in the directory listing and used to sort 
the list. If IBM would provide the document title in the metadata for the PDFs, 
that would go a long way to addressing the complaints about file name.

-- 
Tom Marchant

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[R.S.]

W dniu 2019-02-28 o 04:00, Susan Shumway pisze:

Hi all,

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
as soon as you get the chance.


Susan,
You do much effort to improve the look of documentation, while customers 
just wanted to have bookreader format.



--
Radoslaw Skorupka
Lodz, Poland




==

Jeśli nie jesteś adresatem tej wiadomości:

- powiadom nas o tym w mailu zwrotnym (dziękujemy!),
- usuń trwale tę wiadomość (i wszystkie kopie, które wydrukowałeś lub zapisałeś 
na dysku).
Wiadomość ta może zawierać chronione prawem informacje, które może wykorzystać 
tylko adresat.Przypominamy, że każdy, kto rozpowszechnia (kopiuje, rozprowadza) 
tę wiadomość lub podejmuje podobne działania, narusza prawo i może podlegać 
karze.

mBank S.A. z siedzibą w Warszawie, ul. Senatorska 18, 00-950 
Warszawa,www.mBank.pl, e-mail: kont...@mbank.pl. Sąd Rejonowy dla m. st. 
Warszawy XII Wydział Gospodarczy Krajowego Rejestru Sądowego, KRS 025237, 
NIP: 526-021-50-88. Kapitał zakładowy (opłacony w całości) według stanu na 
01.01.2018 r. wynosi 169.248.488 złotych.

If you are not the addressee of this message:

- let us know by replying to this e-mail (thank you!),
- delete this message permanently (including all the copies which you have 
printed out or saved).
This message may contain legally protected information, which may be used 
exclusively by the addressee.Please be reminded that anyone who disseminates 
(copies, distributes) this message or takes any similar action, violates the 
law and may be penalised.

mBank S.A. with its registered office in Warsaw, ul. Senatorska 18, 00-950 
Warszawa,www.mBank.pl, e-mail: kont...@mbank.pl. District Court for the Capital 
City of Warsaw, 12th Commercial Division of the National Court Register, KRS 
025237, NIP: 526-021-50-88. Fully paid-up share capital amounting to PLN 
169,248,488 as at 1 January 2018.

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Sat, 2 Mar 2019 10:05:26 -0600, Kirk Wolf wrote:

>I use linux and for many years I have organized the IBM z/OS PDFs by making
>symlinks to the actual file name where the symlink name is the actual title
>of the PDF.
>That way, you can easily search for the title (symlink) to find a book, but
>the inter-book links work.
>
>Here's the script that I use to set everything up.   I just tried it with
>the latest zip download of pdfs and it works fine - the inter-document
>links work just fine, like before.
>
>#!/bin/sh
># Make symlinks to all .pdf files in the current directory to names that
>match their Title:
>ls -1 *.pdf | while read f
>do
>  echo "Examining: "$f
>  title=$(pdfinfo "$f" | grep "Title:" | cut -c17- | tr -d '/\\:' | tr ' '
>'_')
>  if test -n "$title" -a ! -s "$title.pdf" ; then
>echo "link $title.pdf -> $f"
>ln -s "$f" "$title.pdf"
>  fi
>done
>
Ah!  Yours is 1/5 the size of mine.  But I met the wish of @sas "to
organize the manuals [symlinks] into directories, according to the
layout on the index.html."  Parsing PITA.

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Kirk Wolf]

I use linux and for many years I have organized the IBM z/OS PDFs by making
symlinks to the actual file name where the symlink name is the actual title
of the PDF.
That way, you can easily search for the title (symlink) to find a book, but
the inter-book links work.

Here's the script that I use to set everything up.   I just tried it with
the latest zip download of pdfs and it works fine - the inter-document
links work just fine, like before.

#!/bin/sh
# Make symlinks to all .pdf files in the current directory to names that
match their Title:
ls -1 *.pdf | while read f
do
  echo "Examining: "$f
  title=$(pdfinfo "$f" | grep "Title:" | cut -c17- | tr -d '/\\:' | tr ' '
'_')
  if test -n "$title" -a ! -s "$title.pdf" ; then
echo "link $title.pdf -> $f"
ln -s "$f" "$title.pdf"
  fi
done


On Sat, Mar 2, 2019 at 2:01 AM Martin Packer 
wrote:

>
> Unless you use an app like Liquid Copy (on iPad) which makes all that very
> easy.
>
> I’m doing a lot of technical book reading that way.
>
> Cheers, Martin
>
> Sent from my iPad
>
> > On 1 Mar 2019, at 23:11, Andrew Rowley 
> wrote:
> >
> >> On 2/03/2019 4:55 am, Seymour J Metz wrote:
> >> I can see making copies for laptops off of the Internet, but dead tree?
> I wish I didn't believe you.
> >>
> > You can tell the people who learned from printed manuals from those who
> > use only softcopy ones - the people who learned from softcopy ask "How
> > do I do..." and the people who learned from hardcopy answer them.
> > (Mostly joking!)
> >
> > I suspect most of us on this list are old enough to have started in
> > mainframe with hardcopy manuals. We may not appreciate how difficult it
> > is to learn z/OS without them.
> >
> > When learning a complex new concept, a hardcopy manual where you can
> > stick a finger in a page, flip backwards, view multiple pages at once,
> > refer to another chapter etc. is much easier than softcopy. Is it
> > surprising that a 1000 page manual contains information that softcopy
> > users never see?
> >
> > There's a couple of manuals I print in full, more often I will print a
> > chapter or 2. Even then the majority of time I use softcopy, but
> > occasionally when it's a complex topic and my brain starts to strain I
> > pull out the hardcopy. I almost always learn something new as I flip
> > through to the correct chapter.
> >
> > I could postulate that the technologies that have met with most
> > resistance on the mainframe (e.g. z/OS Unix, Java) are those that came
> > along after the switch to softcopy manuals, so people never had the
> > opportunity to read and learn from hardcopy.
> >
> >
> > Andrew Rowley
> >
> > --
> > For IBM-MAIN subscribe / signoff / archive access instructions,
> > send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
> >Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number
> 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
>
>
> --
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Martin Packer]

Unless you use an app like Liquid Copy (on iPad) which makes all that very
easy.

I’m doing a lot of technical book reading that way.

Cheers, Martin

Sent from my iPad

> On 1 Mar 2019, at 23:11, Andrew Rowley 
wrote:
>
>> On 2/03/2019 4:55 am, Seymour J Metz wrote:
>> I can see making copies for laptops off of the Internet, but dead tree?
I wish I didn't believe you.
>>
> You can tell the people who learned from printed manuals from those who
> use only softcopy ones - the people who learned from softcopy ask "How
> do I do..." and the people who learned from hardcopy answer them.
> (Mostly joking!)
>
> I suspect most of us on this list are old enough to have started in
> mainframe with hardcopy manuals. We may not appreciate how difficult it
> is to learn z/OS without them.
>
> When learning a complex new concept, a hardcopy manual where you can
> stick a finger in a page, flip backwards, view multiple pages at once,
> refer to another chapter etc. is much easier than softcopy. Is it
> surprising that a 1000 page manual contains information that softcopy
> users never see?
>
> There's a couple of manuals I print in full, more often I will print a
> chapter or 2. Even then the majority of time I use softcopy, but
> occasionally when it's a complex topic and my brain starts to strain I
> pull out the hardcopy. I almost always learn something new as I flip
> through to the correct chapter.
>
> I could postulate that the technologies that have met with most
> resistance on the mainframe (e.g. z/OS Unix, Java) are those that came
> along after the switch to softcopy manuals, so people never had the
> opportunity to read and learn from hardcopy.
>
>
> Andrew Rowley
>
> --
> For IBM-MAIN subscribe / signoff / archive access instructions,
> send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
>Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU


--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Fri, 1 Mar 2019 17:01:27 -0500, Steve Smith wrote:
>
>You really ought to organize the manuals into directories, according to the
>layout on the index.html.  And name the files according to the index.html.
>Why must you stop short of making this really usable?
>
>Cross-manual links have never worked for me, because renaming and
>organizing were much more important. 
>
So you broke it, and now you're reporting that it doesn't work?

>If it is true that links can't even
>go to a specific location in another document, then I'd say they're
>obviously a waste of time & effort.
> 
No, they get you to the vicinity and you can go from the ToC.

I wrote a script that filters the index.html into comands that create
a family of symbolic links "organiz[ing] the manuals into directories,
according to the layout on the index.html."  The original files are not
renamed so the cross-manual links continue to work.

Mostly.  It's an ad-hoc parser entirely dependent on the precise
format of index.html.  It probably missed several files.

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Wed, 27 Feb 2019 21:00:57 -0600, Susan Shumway wrote:
>
>I want to make you aware that every PDF in the z/OS V2.3 library was just 
>refreshed to update the visual style and link coding. Because of the link 
>coding changes, clicking on a link in an old-style PDF to a new style PDF will 
>not work, and vice versa. So, to ensure that all cross-book links continue to 
>work for you, ensure that you download the entire fresh set of library PDFs 
>from 
>https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library as 
>soon as you get the chance.
> 
Most of the links in:
asmr1023.pdfSC26-4940-08HLASM Language Reference
Bibliography

... don't work for me, or they try to downoad from IBM's server
when the docs should be available from the extracted .zip.

Thanks,
gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Andrew Rowley]

On 2/03/2019 5:59 am, Gord Tomlin wrote:

On 2019-02-28 17:53, Andrew Rowley wrote:

> Even one tiny blue underline on a page might make it 5 times the 
cost > to print that page.


The ability to print in grayscale is pretty universal these days.


Yes, but it's a checkbox that is easy to miss or forget, and missing it 
can cost $100+.


Andrew Rowley

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Andrew Rowley]

On 2/03/2019 4:55 am, Seymour J Metz wrote:

I can see making copies for laptops off of the Internet, but dead tree? I wish 
I didn't believe you.

You can tell the people who learned from printed manuals from those who 
use only softcopy ones - the people who learned from softcopy ask "How 
do I do..." and the people who learned from hardcopy answer them. 
(Mostly joking!)


I suspect most of us on this list are old enough to have started in 
mainframe with hardcopy manuals. We may not appreciate how difficult it 
is to learn z/OS without them.


When learning a complex new concept, a hardcopy manual where you can 
stick a finger in a page, flip backwards, view multiple pages at once, 
refer to another chapter etc. is much easier than softcopy. Is it 
surprising that a 1000 page manual contains information that softcopy 
users never see?


There's a couple of manuals I print in full, more often I will print a 
chapter or 2. Even then the majority of time I use softcopy, but 
occasionally when it's a complex topic and my brain starts to strain I 
pull out the hardcopy. I almost always learn something new as I flip 
through to the correct chapter.


I could postulate that the technologies that have met with most 
resistance on the mainframe (e.g. z/OS Unix, Java) are those that came 
along after the switch to softcopy manuals, so people never had the 
opportunity to read and learn from hardcopy.



Andrew Rowley

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Fri, 1 Mar 2019 16:55:33 -0500, Steve Smith wrote:

>I think the new layout, formatting, style, etc. look great.  None of the
>grumblings about margin width and use of color are a problem for me, and
>I'd bet most.
>
Maybe handheld users?  (An unpleasant way to read a manual.)

>I couldn't care less about cross-document links.  As someone else pointed out
> 
They did?  I think they're very useful.  I wish only that they were more 
precise.

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Steve Smith]

g... gmail

You really ought to organize the manuals into directories, according to the
layout on the index.html.  And name the files according to the index.html.
Why must you stop short of making this really usable?

Cross-manual links have never worked for me, because renaming and
organizing were much more important.  If it is true that links can't even
go to a specific location in another document, then I'd say they're
obviously a waste of time & effort.

sas


On Fri, Mar 1, 2019 at 4:55 PM Steve Smith  wrote:

> I think the new layout, formatting, style, etc. look great.  None of the
> grumblings about margin width and use of color are a problem for me, and
> I'd bet most.
>
> I couldn't care less about cross-document links.  As someone else pointed
> out
>
> On Fri, 1 Mar 2019 14:50:27 -0500, Susan Shumway wrote:
>>
>> >Thank you all for the feedback and suggestions! I've collected it all
>> >and will work with the team to sort out items that aren't already on our
>> >radar and add them to our list of potential improvements. I can tell
>> >right now that some items are within our control and some unfortunately
>> >aren't, but we'll do our best to implement as many as possible.
>>
>

-- 
sas

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Steve Smith]

I think the new layout, formatting, style, etc. look great.  None of the
grumblings about margin width and use of color are a problem for me, and
I'd bet most.

I couldn't care less about cross-document links.  As someone else pointed
out

On Fri, 1 Mar 2019 14:50:27 -0500, Susan Shumway wrote:
>
> >Thank you all for the feedback and suggestions! I've collected it all
> >and will work with the team to sort out items that aren't already on our
> >radar and add them to our list of potential improvements. I can tell
> >right now that some items are within our control and some unfortunately
> >aren't, but we'll do our best to implement as many as possible.
>

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Fri, 1 Mar 2019 14:50:27 -0500, Susan Shumway wrote:

>Thank you all for the feedback and suggestions! I've collected it all
>and will work with the team to sort out items that aren't already on our
>radar and add them to our list of potential improvements. I can tell
>right now that some items are within our control and some unfortunately
>aren't, but we'll do our best to implement as many as possible.
>
Thanks.  I note in a directory of the 2017 edition:
605 $ unzip -v /Users/paulgilm/Sites/ibmdoc/17Q2A/c27843007.zip | head -11
Archive:  /Users/paulgilm/Sites/ibmdoc/17Q2A/c27843007.zip
 Length   MethodSize  Ratio   Date   Time   CRC-32Name
  --  --- -         --
  171427  Defl:N   166357   3%  07-14-17 17:33  d7493e45  ZOSV02R03/How to 
Search Using Adobe Indexed PDFs.pdf
   0  Stored0   0%  07-14-17 19:22    ZOSV02R03/pdf/
  621232  Defl:N   316044  49%  07-14-17 17:34  ae8b9a6f  
ZOSV02R03/pdf/ab0in022.pdf
 4708978  Defl:N  3239454  31%  07-14-17 17:36  0bdb2f89  
ZOSV02R03/pdf/adru000_v2r3.pdf
...
And in the current (apparently Work in Progress):
606 $ unzip -v  *.zip | head -11
Archive:  zOSV2R3Library.zip
 Length   MethodSize  Ratio   Date   Time   CRC-32Name
  --  --- -         --
  300963  Defl:N   245338  19%  03-01-19 01:47  13682bda  eox01m05.pdf
 3269712  Defl:N  2395601  27%  03-01-19 01:47  9478b6c0  asmp1023.pdf
 2515009  Defl:N  1691347  33%  03-01-19 01:47  c5714772  dpr1cg01.pdf
 3479762  Defl:N  2940576  16%  03-01-19 01:47  53cce700  eph3z100.pdf
...
The .pdf files are a couple directory levels shallower.  I'll recommend zipping 
from
at least one directory level farther rootward.  Several hundred naked PDF files 
can
be a rude surprise to a user who unwittingly unzips into a non-empty directory.

Cosmetic: In index.html, I see "PDF Files for Download".  Not 
very
meaningful unlsess I intend to further serve them from my system to another.

Hmmm... The timestamps in the archive are several hours in the future from when
I dowloaded it.  Is the date on your system set correctly?

The headers I captured in 2017 say:
614 $ cat /Users/paulgilm/Sites/ibmdoc/17Q2A/c27843007.zip.headers 
HTTP/1.1 200 OK
Date: Sun, 29 Oct 2017 02:29:33 GMT
Last-Modified: Mon, 17 Jul 2017 14:37:25 GMT
ETag: "6ca402-42ee3cbb-55484565e7340"
Accept-Ranges: bytes
Content-Length: 1122909371
Connection: close
Content-Type: application/zip

... a meaningful "Content-Length: 1122909371".

Today:
538 $ curl -I  
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/xDownloadFilesToZip.xsp?releaseID=zOSV2R3=zOSV2R3Library.zip
[1] 5930
539 $ HTTP/1.1 200 OK
Server: Lotus-Domino
Cache-Control: no-cache
Expires: Wed, 31 Dec 1969 23:59:59 GMT
Content-Type: application/zip
Content-Disposition: attachment; filename=AllFiles.zip
Strict-Transport-Security: max-age=0
Content-Length: 0
Date: Fri, 01 Mar 2019 20:41:41 GMT
Connection: keep-alive
Set-Cookie: SessionID=8FA23C3480C8DB04F645DD6A548E73C740D9C8D7; path=/; HttpOnly

... "Content-Length: 0"?  Server: Lotus-Domino appears to be broken.

Thanks again,
gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tom Brennan]

Thanks!  I'll use that Chrome setting for now on.  It means an extra 
click once a pdf is downloaded, but I'm used to that for word/excel etc. 
 And then I get the benefit of the "real" pdf search and other features.


But for the local-disk IBM pdf's: the pretend download and multiple 
copies (like you say), and the fact that the book-to-book links won't 
work, make me think I'll just stay with the Shortcut method for now.


On 3/1/2019 12:54 PM, Wendell Lovewell wrote:

Hi Tom.

You can change the way Chrome handles PDFs via 
chrome://settings/content/pdfDocuments?search=pdf

index.html will get you to the file you want, but since you're going through a 
web browser, clicking the link, at least in Chrome, will cause the file to be 
copied to your download folder before it's opened--even if it's already there.  
If you open the same manual 3 times, you end up with 3 copies of it in your 
folder.

Wendell

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN




--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Wendell Lovewell]

Hi Tom.  

You can change the way Chrome handles PDFs via 
chrome://settings/content/pdfDocuments?search=pdf

index.html will get you to the file you want, but since you're going through a 
web browser, clicking the link, at least in Chrome, will cause the file to be 
copied to your download folder before it's opened--even if it's already there.  
If you open the same manual 3 times, you end up with 3 copies of it in your 
folder.

Wendell

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Susan Shumway]

Thank you all for the feedback and suggestions! I've collected it all 
and will work with the team to sort out items that aren't already on our 
radar and add them to our list of potential improvements. I can tell 
right now that some items are within our control and some unfortunately 
aren't, but we'll do our best to implement as many as possible.


For a little background on the new look of the PDFs, we were instructed 
to move to new build tooling, and the new PDF visual style just came 
along with it. Our team worked hard over the past months to prepare our 
z/OS content source for the drastic under-the-covers changes, but 
there's still work to do on the source and, if deemed necessary and 
possible via requirements or such, on the tooling. Rest assured that 
we'll continue working to make the PDFs as usable as possible for you all!


In response to the comments about PDF file names, you REALLY don't want 
to rename the PDFs. Most importantly, doing so breaks all cross-book 
links. Instead, as suggested by others here, use the index.html file. To 
do so, go to the PDF download page ( 
https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
), select "Download all z/OS V2R3 Library publications to ZIP file," 
extract the whole thing into the suggested directory structure, open the 
included index.html file, and click the links to open the downloaded 
local versions of the PDFs. Alternatively, on the PDF download page, you 
can just click "Show all PDF files" and then search for a cryptic 
(though sans any spaces or weird characters!) file name or title or 
order number to quickly map it to the other information about a PDF. 
I've even been known to do this myself in a pinch.


Also, Gil asked about "zOS_V2R3_Documentation.pdx". That's very much 
still around - it's the search file for the Acrobat Indexed PDF 
collection. We'll have a fresh V2R3 collection that contains all these 
new DCS PDFs posted within the next few days. If you bookmark and always 
start at the z/OS Internet Library ( 
http://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zosInternetLibrary 
), you'll always see all the different options for product 
documentation, other content, related helpful tools, etc.


We really appreciate this feedback, so please keep it coming. (The best 
way to do so is through the "Feedback" link on KC: 
https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3/en/homepage.html 
. It's then formally tracked and you get updates on progress.) As 
always, feel free to drop me a direct note if you have a question and 
I'll try to help.


-Sue Shumway

--
Sue Shumway
z/OS Product Documentation Lead
IBM Poughkeepsie
chale...@us.ibm.com


On 2/28/2019 9:54 PM, Paul Gilmartin wrote:

On Wed, 27 Feb 2019 21:00:57 -0600, Susan Shumway wrote:


I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
as soon as you get the chance.


Now I'm trying it.  Seems pretty good.

It would be nice if the web metadata included file size so I could eagerly
watch the progress bar during download.

Is the "zOS_V2R3_Documentation.pdx" index gone?  I sometimes found it useful.

It would sure be nice if the cross-document references pointed to a chapter, not
just to the title page of the referenced document.  I suspect that's not easy 
to do.
  


On Thu, 28 Feb 2019 13:52:20 +, Allan Staller wrote:


Ref: 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library

I observed one thing.hThe introductory "new style" screens are portrait 
oriented and take up a lot  of vertical real estate.
The new screens generate a lot of unnecessary scrolling.

I have a laptop and a desktop, both with landscape oriented monitors.
The only portrait oriented device I have is a cell phone.


For that it would be nice if the doc were semantic-oriented html, adapting
to screen geometry, not presentation-oriented.  Not likely to happen.


On Thu, 28 Feb 2019 10:06:52 -0600, Wendell Lovewell wrote:


Thanks for the update Sue.  I'm not sure how we would find out this information 
without your posting it here.

1) Could you please use the full title names (minus "/" and ":" characters) for 
the file names?  The 8.3 file names (actually, they aren't all 8-character anymore) are not very 
usable.


Use the index.html file.


I generally use Windows File Explorer to find a manual I've downloaded.  But to be able to find something by 
the file system name, I have to open each to determine which manual it is, copy the title (and maybe the 
publication number), close the pdf and then rename 

Re: New look and linking for V2.3 product documentation PDFs

[Gord Tomlin]

On 2019-02-28 17:53, Andrew Rowley wrote:

My main comment is: People still print manuals and work from printed copies.


Not many, I hope. It's 2019.

> Even one tiny blue underline on a page might make it 5 times the cost 
> to print that page.


The ability to print in grayscale is pretty universal these days.

--

Regards, Gord Tomlin
Action Software International
(a division of Mazda Computer Corporation)
Tel: (905) 470-7113, Fax: (905) 470-6507
Support: https://actionsoftware.com/support/

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Seymour J Metz]

I can see making copies for laptops off of the Internet, but dead tree? I wish 
I didn't believe you.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Discussion List  on behalf of 
Andrew Rowley 
Sent: Thursday, February 28, 2019 5:53 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: Re: New look and linking for V2.3 product documentation PDFs

On 28/02/2019 2:00 pm, Susan Shumway wrote:
> I want to make you aware that every PDF in the z/OS V2.3 library was just 
> refreshed to update the visual style and link coding.

I'm not thrilled by the new style, but I will probably get used to it.
What was the objective for the change?

My main comment is: People still print manuals and work from printed
copies. It looks like the margins in the new layout are a bit small for
printing and binding. Also, given the typical size of these manuals,
black and white was appreciated. Even one tiny blue underline on a page
might make it 5 times the cost to print that page.

--

Andrew Rowley
Black Hill Software

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Wed, 27 Feb 2019 21:00:57 -0600, Susan Shumway wrote:
>
>I want to make you aware that every PDF in the z/OS V2.3 library was just 
>refreshed to update the visual style and link coding. Because of the link 
>coding changes, clicking on a link in an old-style PDF to a new style PDF will 
>not work, and vice versa. So, to ensure that all cross-book links continue to 
>work for you, ensure that you download the entire fresh set of library PDFs 
>from 
>https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library as 
>soon as you get the chance.
> 
Now I'm trying it.  Seems pretty good.

It would be nice if the web metadata included file size so I could eagerly
watch the progress bar during download.

Is the "zOS_V2R3_Documentation.pdx" index gone?  I sometimes found it useful.

It would sure be nice if the cross-document references pointed to a chapter, not
just to the title page of the referenced document.  I suspect that's not easy 
to do.
 

On Thu, 28 Feb 2019 13:52:20 +, Allan Staller wrote:

>Ref: 
>https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library
>
>I observed one thing.hThe introductory "new style" screens are portrait 
>oriented and take up a lot  of vertical real estate.
>The new screens generate a lot of unnecessary scrolling.
>
>I have a laptop and a desktop, both with landscape oriented monitors.
>The only portrait oriented device I have is a cell phone.
>
For that it would be nice if the doc were semantic-oriented html, adapting
to screen geometry, not presentation-oriented.  Not likely to happen.


On Thu, 28 Feb 2019 10:06:52 -0600, Wendell Lovewell wrote:

>Thanks for the update Sue.  I'm not sure how we would find out this 
>information without your posting it here. 
>
>1) Could you please use the full title names (minus "/" and ":" characters) 
>for the file names?  The 8.3 file names (actually, they aren't all 8-character 
>anymore) are not very usable.
>
Use the index.html file.

>I generally use Windows File Explorer to find a manual I've downloaded.  But 
>to be able to find something by the file system name, I have to open each to 
>determine which manual it is, copy the title (and maybe the publication 
>number), close the pdf and then rename it.  "asmr1023.pdf" is not meaningful. 
>"SC26-4940-08 HLASM Language Reference.pdf" is.  And if the title has a slash, 
>colon, or other invalid character for a file name, I have to remove those.  
>(There might be reasons to replace the spaces with underscores.)  It's often 
>easier to copy the pub # and title and use "Save As" so that I can use the 
>full title as a file name.  Of course, this breaks any links between manuals.  
> 
Use symbolic links rather than renaming.

>2) The second thing to please stop dividing the manuals into sections so that 
>the page numbers referenced from the TOC and all other places within the 
>manual are the actual PDF page numbers. PDF doesn't (generally) recognize 
>sections like this, so page numbers cited in the manual are always several 
>pages short of the PDF page number.   (Hyperlinks from the TOC are great, but 
>references to page numbers within the text are usually not set up as links.)  
> 
I do not have this problem with my PDF viewer, ancient MacOS Preview.  Does this
problem occur when you just click on a ToC entry?


On Thu, 28 Feb 2019 11:46:27 -0500, Gord Tomlin  wrote:

>On 2019-02-28 11:06, Wendell Lovewell wrote:
>> (There might be reasons to replace the spaces with underscores.)
>
>Blanks in file names can be a hassle on Linux.
>
Hasn't bothered me that much.


On Fri, 1 Mar 2019 09:53:57 +1100, Andrew Rowley wrote:
>
>black and white was appreciated. Even one tiny blue underline on a page
>might make it 5 times the cost to print that page.
> 
Can't you override to monochrome in your printer setup?


On Thu, 28 Feb 2019 15:30:49 -0800, Tom Brennan wrote:

>On 2/28/2019 2:39 PM, Andrew Rowley wrote:
>> On 1/03/2019 4:10 am, Tom Brennan wrote:
>>> Personally, I don't really like the index.html method IBM provides, so
>>
>> I do! I think it's one of the most usable ways to access the manuals IBM
>> has provided in a long time.
>
>Sorry I wasn't very clear!  I do like index.html a whole lot better than
>my old method which was (like Wendell) renaming the pdf files to their
>title.  And of course I really appreciate being able to download the
>whole collection all at once.
> 
Old stuff.  That's been available for a couple years.

>Really, my only problem with index.html is that (at least in Chrome) the
>pdf file is opened in the browser.
>
Firefox doesn't do that to me.  I guess I'm just lucky.

>...  There are probably Chrome ways around that if I would just look.  
>
That's configurable in Firefox, but sometimes I forget how.

>Oh... one other nitpick - I always
>tend to try to click the Title but I need to click the filename to the
>left instead.  But that's just me being overly picky.
> 
Too many web page designers do that to you.

-- gil

Re: New look and linking for V2.3 product documentation PDFs

[Tom Brennan]

On 2/28/2019 2:39 PM, Andrew Rowley wrote:

On 1/03/2019 4:10 am, Tom Brennan wrote:
Personally, I don't really like the index.html method IBM provides, so 
I made a VBS script that takes that index and turns it into a pile of 
Windows shortcuts with group directory names and manual titles (bad 
characters taken out).  Send me an email if you want to try it.


I do! I think it's one of the most usable ways to access the manuals IBM 
has provided in a long time.


Sorry I wasn't very clear!  I do like index.html a whole lot better than 
my old method which was (like Wendell) renaming the pdf files to their 
title.  And of course I really appreciate being able to download the 
whole collection all at once.


Really, my only problem with index.html is that (at least in Chrome) the 
pdf file is opened in the browser.  So I'm stuck using the browser's 
search method, among other things.  There are probably Chrome ways 
around that if I would just look.  Oh... one other nitpick - I always 
tend to try to click the Title but I need to click the filename to the 
left instead.  But that's just me being overly picky.


--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Andrew Rowley]

On 1/03/2019 9:51 am, Paul Gilmartin wrote:


But, is this a collection of PDFs, as Susan seems to say, or a hierarchy
or browser pages, as the subsequent plies mostly say?

It's a collection of PDFs. The index.html is an old fashioned web page 
with tables grouping and listing titles with relative links to the PDF.


It works much better than most bookshelf lists, basically due to the 
simplicity.


--
Andrew Rowley
Black Hill Software

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Andrew Rowley]

On 28/02/2019 2:00 pm, Susan Shumway wrote:

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding.


I'm not thrilled by the new style, but I will probably get used to it. 
What was the objective for the change?


My main comment is: People still print manuals and work from printed 
copies. It looks like the margins in the new layout are a bit small for 
printing and binding. Also, given the typical size of these manuals, 
black and white was appreciated. Even one tiny blue underline on a page 
might make it 5 times the cost to print that page.


--

Andrew Rowley
Black Hill Software

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Paul Gilmartin]

On Fri, 1 Mar 2019 09:39:55 +1100, Andrew Rowley wrote:

>On 1/03/2019 4:10 am, Tom Brennan wrote:
>> Personally, I don't really like the index.html method IBM provides, so
>> I made a VBS script that takes that index and turns it into a pile of
>> Windows shortcuts with group directory names and manual titles (bad
>> characters taken out).  Send me an email if you want to try it.
>
>I do! I think it's one of the most usable ways to access the manuals IBM
>has provided in a long time.
>
>It's helped by the browser convention of showing visited links in a
>different color, so it is very fast and easy to spot the links to the
>manuals I use.
> 
I haven't grabbed it yet; I'm waiting for the rest of the reviews.

But, is this a collection of PDFs, as Susan seems to say, or a hierarchy
or browser pages, as the subsequent plies mostly say?

-- gil

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Andrew Rowley]

On 1/03/2019 4:10 am, Tom Brennan wrote:
Personally, I don't really like the index.html method IBM provides, so 
I made a VBS script that takes that index and turns it into a pile of 
Windows shortcuts with group directory names and manual titles (bad 
characters taken out).  Send me an email if you want to try it.


I do! I think it's one of the most usable ways to access the manuals IBM 
has provided in a long time.


It's helped by the browser convention of showing visited links in a 
different color, so it is very fast and easy to spot the links to the 
manuals I use.


--
Andrew Rowley
Black Hill Software

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tom Brennan]

Sue - long story, sorry:

In the 90's we had a web server running (where else?) on MVS with web 
pages designed for application programmers and others who needed 
information about various local things - from RACF to TMS to how to get 
your TSO id cancelled.  I created the main web page format and style, 
headings, navigation bar, etc., and yeah, I'm not a real artist.  Other 
contributors had their own styles.  Around that time, the company had 
created their own "Intranet" web site, professionally designed, and 
someone decided to make a link from the company site to our little 
mainframe web site.  Cool, I thought at first, but I was wrong.  There 
was trouble brewing.


Next thing I knew, company Intranet managers were telling me I had to 
change the format of all our web pages to match the company web site 
style.  WHY?  I asked - our users care about the content, not the 
format.  In fact, since people are USED TO the old format, any changes 
would make things more difficult for them.  I was pressured, so I lied 
and told them I was working on it.  In addition, they wanted to add our 
mainframe doc to their main Intranet search facility, under the idea 
that a user should be able to find everything from one place.


Both of those ideas are silly.  When you search for how to order a box 
of printer paper, you don't want mainframe results popping up.  The 
whole idea of web pages is that you drill down.  You go to a mainframe 
site knowing (partly by the fact that the pages look different than 
where you came from) that you are in the mainframe realm.  And you get 
used to the format and are surprised if it suddenly changes to look like 
some other area that has nothing to do with mainframes.


So these are some of the things I felt when I opened one of the newly 
formatted pdf manuals just now.


On 2/27/2019 7:00 PM, Susan Shumway wrote:

Hi all,

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
as soon as you get the chance.

-Sue Shumway

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN




--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Tom Brennan]

Personally, I don't really like the index.html method IBM provides, so I 
made a VBS script that takes that index and turns it into a pile of 
Windows shortcuts with group directory names and manual titles (bad 
characters taken out).  Send me an email if you want to try it.


On 2/28/2019 8:06 AM, Wendell Lovewell wrote:

Thanks for the update Sue.  I'm not sure how we would find out this information 
without your posting it here.

I personally really appreciate you continuing to create the PDF versions of the 
manuals.   But there are a couple of things that would make them a lot easier 
to use.

1) Could you please use the full title names (minus "/" and ":" characters) for 
the file names?  The 8.3 file names (actually, they aren't all 8-character anymore) are not very 
usable.  If we download the HLASM and MFA zip files, we get:
asmg1023.pdf
asmi1023.pdf
asmp1023.pdf
asmr1023.pdf
asmtic23.pdf
asmtis23.pdf
asmtiu23.pdf
asmtug23.pdf
azfi100_v1r3.pdf
azfli100_v1r3.pdf
azfpd130.pdf
azfu100_v1r3.pdf

I generally use Windows File Explorer to find a manual I've downloaded.  But to be able to find something by 
the file system name, I have to open each to determine which manual it is, copy the title (and maybe the 
publication number), close the pdf and then rename it.  "asmr1023.pdf" is not meaningful. 
"SC26-4940-08 HLASM Language Reference.pdf" is.  And if the title has a slash, colon, or other 
invalid character for a file name, I have to remove those.  (There might be reasons to replace the spaces 
with underscores.)  It's often easier to copy the pub # and title and use "Save As" so that I can 
use the full title as a file name.  Of course, this breaks any links between manuals.

2) The second thing to please stop dividing the manuals into sections so that 
the page numbers referenced from the TOC and all other places within the manual 
are the actual PDF page numbers. PDF doesn't (generally) recognize sections 
like this, so page numbers cited in the manual are always several pages short 
of the PDF page number.   (Hyperlinks from the TOC are great, but references to 
page numbers within the text are usually not set up as links.)

So, to jump to a page (Ctrl-G in most PDF readers) I usually add at least 10 pages to get close, 
then scroll to what the book thinks is the right page.  For example, in "asmr1023.pdf", 
if you want to go to page 61, you would actually need to enter "77" because of the reset 
in the page numbers after the first 16 pages.  In John Erhman's wonderful Assembler book there's a 
42 page difference, and there are so many references to page numbers in the text that I used a PDF 
editor to delete everything prior to what it calls page 1 so that I could go directly to the 
referenced page--at the cost of having a table of contents.

Thanks for listening.

Wendell Lovewell

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN




--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Gord Tomlin]

On 2019-02-28 11:06, Wendell Lovewell wrote:

(There might be reasons to replace the spaces with underscores.)


Blanks in file names can be a hassle on Linux.

--

Regards, Gord Tomlin
Action Software International
(a division of Mazda Computer Corporation)
Tel: (905) 470-7113, Fax: (905) 470-6507
Support: https://actionsoftware.com/support/

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Wendell Lovewell]

Thanks for the update Sue.  I'm not sure how we would find out this information 
without your posting it here. 

I personally really appreciate you continuing to create the PDF versions of the 
manuals.   But there are a couple of things that would make them a lot easier 
to use.

1) Could you please use the full title names (minus "/" and ":" characters) for 
the file names?  The 8.3 file names (actually, they aren't all 8-character 
anymore) are not very usable.  If we download the HLASM and MFA zip files, we 
get:
asmg1023.pdf
asmi1023.pdf
asmp1023.pdf
asmr1023.pdf
asmtic23.pdf
asmtis23.pdf
asmtiu23.pdf
asmtug23.pdf
azfi100_v1r3.pdf
azfli100_v1r3.pdf
azfpd130.pdf
azfu100_v1r3.pdf

I generally use Windows File Explorer to find a manual I've downloaded.  But to 
be able to find something by the file system name, I have to open each to 
determine which manual it is, copy the title (and maybe the publication 
number), close the pdf and then rename it.  "asmr1023.pdf" is not meaningful. 
"SC26-4940-08 HLASM Language Reference.pdf" is.  And if the title has a slash, 
colon, or other invalid character for a file name, I have to remove those.  
(There might be reasons to replace the spaces with underscores.)  It's often 
easier to copy the pub # and title and use "Save As" so that I can use the full 
title as a file name.  Of course, this breaks any links between manuals.  

2) The second thing to please stop dividing the manuals into sections so that 
the page numbers referenced from the TOC and all other places within the manual 
are the actual PDF page numbers. PDF doesn't (generally) recognize sections 
like this, so page numbers cited in the manual are always several pages short 
of the PDF page number.   (Hyperlinks from the TOC are great, but references to 
page numbers within the text are usually not set up as links.)  

So, to jump to a page (Ctrl-G in most PDF readers) I usually add at least 10 
pages to get close, then scroll to what the book thinks is the right page.  For 
example, in "asmr1023.pdf", if you want to go to page 61, you would actually 
need to enter "77" because of the reset in the page numbers after the first 16 
pages.  In John Erhman's wonderful Assembler book there's a 42 page difference, 
and there are so many references to page numbers in the text that I used a PDF 
editor to delete everything prior to what it calls page 1 so that I could go 
directly to the referenced page--at the cost of having a table of contents.

Thanks for listening.

Wendell Lovewell

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Gord Tomlin]

On 2019-02-27 22:00, Susan Shumway wrote:

Hi all,

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from https://www.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library 
as soon as you get the chance.

-Sue Shumway

Thanks for pointing this out, Sue.

I have to say I'm not particularly happy with the new PDFs. I opened the 
new and previous versions of the same manuals in a few different PDF 
readers to compare. Here are my observations:


1. The line length of body text has been increased by approximately 25 
characters. The old PDFs had lines of about 75-80 characters (including 
blanks), and the new ones are more like 100-105 characters. A line width 
of 45-75 characters is generally considered to be best for readability. 
Try reading the same paragraph in both versions of the same PDF, and I 
think you will find that the old one is easier to read.


2. The bookmarks (ToC) in the previous PDFs were expanded to the chapter 
level. In the new PDFs, they are exploded to the first level of 
subheadings below the chapter level (on Adobe Reader or Evince Document 
Reader) or fully exploded (SumatraPDF reader). It now takes longer to 
locate a topic.


3. In Adobe Reader, the bookmarks are now shown with black text on a 
dark gray background. They are unnecessarily difficult to read. The old 
display (white text on a dark gray background) were much easier to read.


Taken together, these factors make the new PDFs harder to read and 
harder to navigate.


--

Regards, Gord Tomlin
Action Software International
(a division of Mazda Computer Corporation)
Tel: (905) 470-7113, Fax: (905) 470-6507
Support: https://actionsoftware.com/support/

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: [EXTERNAL] Re: New look and linking for V2.3 product documentation PDFs

[Sankaranarayanan, Vignesh]

+1000

Poor use of top half of the screen (I'm referring to KC pages)
1. The 'IBM Knowledge Center' banner needn't be permanent, could be an 
auto-close area
2. The blue area showing the section that is currently open (Home > z/OS 2.3.0 
> etc etc), and the huge section header
3. Table of Contents / Change version or Product is its own row. Does it need 
to be?
4. I would rather see the ToC permanently in the left than waste space on the 
right side for Related Topics
5. The huge banner at the bottom.

I block most of these off using an ad block but it would be great if the site 
itself screamed "speed".

For reference, try opening any indexed PDF in Sumatra PDF reader.
Bare bones to the core, but gives you an idea of what's great UX.

– Vignesh
Mainframe Infrastructure

-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
Allan Staller
Sent: 28 February 2019 13:52
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: [EXTERNAL] Re: New look and linking for V2.3 product documentation PDFs

Ref: 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library

I observed one thing. The introductory "new style" screens are portrait 
oriented and take up a lot  of vertical real estate.
The new screens generate a lot of unnecessary scrolling.

I have a laptop and a desktop, both with landscape oriented monitors.
The only portrait oriented device I have is a cell phone.

I can’t speak for everyone, but I spend *VERY LITTLE* time reviewing manuals on 
my cell phone.
Reduced use  of vertical real estate would go a long way to enhancing the user 
experience.

Thanks for all of your efforts and thanks for the heads up on the new link 
styles.



-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
Susan Shumway
Sent: Wednesday, February 27, 2019 9:01 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: New look and linking for V2.3 product documentation PDFs

Hi all,

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from 
https://apac01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ibm.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2FzOSV2R3Librarydata=02%7C01%7Callan.staller%40HCL.COM%7C387bcaf360e54f3564d808d69d290d06%7C189de737c93a4f5a8b686f4ca9941912%7C0%7C1%7C636869197008313274sdata=Wj%2FzVYo2im8YpdAP9Wwiq5%2BxR0XUCsG6okyRhAba25E%3Dreserved=0
 as soon as you get the chance.

-Sue Shumway

--
For IBM-MAIN subscribe / signoff / archive access instructions, send email to 
lists...@listserv.ua.edu with the message: INFO IBM-MAIN
::DISCLAIMER::
--
The contents of this e-mail and any attachment(s) are confidential and intended 
for the named recipient(s) only. E-mail transmission is not guaranteed to be 
secure or error-free as information could be intercepted, corrupted, lost, 
destroyed, arrive late or incomplete, or may contain viruses in transmission. 
The e mail and its contents (with or without referred errors) shall therefore 
not attach any liability on the originator or HCL or its affiliates. Views or 
opinions, if any, presented in this email are solely those of the author and 
may not necessarily reflect the views or opinions of HCL or its affiliates. Any 
form of reproduction, dissemination, copying, disclosure, modification, 
distribution and / or publication of this message without the prior written 
consent of authorized representative of HCL is strictly prohibited. If you have 
received this email in error please delete it and notify the sender 
immediately. Before opening any email and/or attachments, please check them for 
viruses and other defects.
--

--
For IBM-MAIN subscribe / signoff / archive access instructions, send email to 
lists...@listserv.ua.edu with the message: INFO IBM-MAIN

MARKSANDSPENCER.COM

 Unless otherwise stated above:
Marks and Spencer plc
Registered Office:
Waterside House
35 North Wharf Road
London
W2 1NW

Registered No. 214436 in England and Wales.

Re: New look and linking for V2.3 product documentation PDFs

[Allan Staller]

Ref: 
https://www-01.ibm.com/servers/resourcelink/svc00100.nsf/pages/zOSV2R3Library

I observed one thing. The introductory "new style" screens are portrait 
oriented and take up a lot  of vertical real estate.
The new screens generate a lot of unnecessary scrolling.

I have a laptop and a desktop, both with landscape oriented monitors.
The only portrait oriented device I have is a cell phone.

I can’t speak for everyone, but I spend *VERY LITTLE* time reviewing manuals on 
my cell phone.
Reduced use  of vertical real estate would go a long way to enhancing the user 
experience.

Thanks for all of your efforts and thanks for the heads up on the new link 
styles.



-Original Message-
From: IBM Mainframe Discussion List  On Behalf Of 
Susan Shumway
Sent: Wednesday, February 27, 2019 9:01 PM
To: IBM-MAIN@LISTSERV.UA.EDU
Subject: New look and linking for V2.3 product documentation PDFs

Hi all,

I want to make you aware that every PDF in the z/OS V2.3 library was just 
refreshed to update the visual style and link coding. Because of the link 
coding changes, clicking on a link in an old-style PDF to a new style PDF will 
not work, and vice versa. So, to ensure that all cross-book links continue to 
work for you, ensure that you download the entire fresh set of library PDFs 
from 
https://apac01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ibm.com%2Fservers%2Fresourcelink%2Fsvc00100.nsf%2Fpages%2FzOSV2R3Librarydata=02%7C01%7Callan.staller%40HCL.COM%7C387bcaf360e54f3564d808d69d290d06%7C189de737c93a4f5a8b686f4ca9941912%7C0%7C1%7C636869197008313274sdata=Wj%2FzVYo2im8YpdAP9Wwiq5%2BxR0XUCsG6okyRhAba25E%3Dreserved=0
 as soon as you get the chance.

-Sue Shumway

--
For IBM-MAIN subscribe / signoff / archive access instructions, send email to 
lists...@listserv.ua.edu with the message: INFO IBM-MAIN
::DISCLAIMER::
--
The contents of this e-mail and any attachment(s) are confidential and intended 
for the named recipient(s) only. E-mail transmission is not guaranteed to be 
secure or error-free as information could be intercepted, corrupted, lost, 
destroyed, arrive late or incomplete, or may contain viruses in transmission. 
The e mail and its contents (with or without referred errors) shall therefore 
not attach any liability on the originator or HCL or its affiliates. Views or 
opinions, if any, presented in this email are solely those of the author and 
may not necessarily reflect the views or opinions of HCL or its affiliates. Any 
form of reproduction, dissemination, copying, disclosure, modification, 
distribution and / or publication of this message without the prior written 
consent of authorized representative of HCL is strictly prohibited. If you have 
received this email in error please delete it and notify the sender 
immediately. Before opening any email and/or attachments, please check them for 
viruses and other defects.
--

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN

Re: New look and linking for V2.3 product documentation PDFs

[Elardus Engelbrecht]

Susan Shumway wrote:

>I want to make you aware that every PDF in the z/OS V2.3 library was just 
>refreshed to update the visual style and link coding. 

Excellent! Thanks for sharing this good news.

Groete / Greetings
Elardus Engelbrecht

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN