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" <chale...@us.ibm.com> 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 +0000, 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 > > ---------------------------------------------------------------------- > 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 ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN
