Re: [j-nsp] Juniper publishes Release notes as pdf
I think the main story here is: Offer both/different versions! Once the content is there it should be very little effort to render multiple different outputs. In the days of ancient past you could just convert each section/page of the website (including Release Notes) into a PDF (documentation still has that at most locations) or get a properly authored PDF version which has use-cases e.g.: - searching it - offline availability (i have been in "offline" situations where help apropos did not cut it, bonus points during an outage) (Back than we even could download a full documentation PDF bundle/"CD" in one place which again is cool to have offline or to fullfill the "we want to have all documentation handed to us" tender knob :)) I am also not a big fan that the HTML based Release Notes have been changed month/years ago to have clickable section per subchapter (e.g. per feature family per platform) where it once was one bigger document. Want to scroll trough everything new on e.g. 22.1R1 for MX? https://www.juniper.net/documentation/us/en/software/junos/release-notes/22.1/junos-release-notes-22.1r1/topics/new-features/mx-new-features-22.1r1.html Nope, clicking dozens of times it is Want the same for 20.4? https://www.juniper.net/documentation/en_US/junos/information-products/topic-collections/release-notes/20.4/topic-150554.html#jd0e7524 Just scroll (or ctrl+f) if i want a PDF i can click the button in the top right (as long as it is still there). regards Tobias Am 18.03.2024 um 16:59 schrieb Michael Hare via juniper-nsp: TLDR: Juniper: please keep the PDFs. I like control-F. I may need a lesson in remedial use of browsers, but I find the PDFs useful and I don't print them. Do people really have the time to navigate/click on all of these hyperlinks, or am I missing an obvious way to control-F the entire release notes in the web? Example: https://www.juniper.net/documentation/us/en/software/junos/release-notes/22.4/junos-release-notes-22.4r1/index.html -Michael -Original Message- From: juniper-nsp On Behalf Of Andrey Kostin via juniper-nsp Sent: Monday, March 18, 2024 7:37 AM To: Joe Horton Cc: Juniper Nsp Subject: Re: [j-nsp] Juniper publishes Release notes as pdf Thanks, Joe. Right, pdf only for SR releases has been a while, but not very long, the change happened just few months ago. My personal preference would be to read html that can adapt to screen size, etc. Imo the value of pdf is to be able to print a paper copy, but it's hard to imagine that somebody would print release notes in the present time. Kind regards, Andrey Joe Horton via juniper-nsp писал(а) 2024-03-15 21:36: Correct. SR releases – PDF only, and I think it has been that way a while. R release – html/web based + PDF And understand, I’ll pass along the feedback to the docs team. Joe ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://urldefense.com/v3/__https://puck.nether.net/mailman/listinfo/junip er- nsp__;!!Mak6IKo!KwspzhVpA4H07DE07WwOX7O2Mcz02FfnRg1MEuPyGll8k uhy28xOFgROPz-6ojKOiKfVJ4bNsRh3o85dwy4jnaE8Nzc$ ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
Re: [j-nsp] Juniper publishes Release notes as pdf
TLDR: Juniper: please keep the PDFs. I like control-F. I may need a lesson in remedial use of browsers, but I find the PDFs useful and I don't print them. Do people really have the time to navigate/click on all of these hyperlinks, or am I missing an obvious way to control-F the entire release notes in the web? Example: https://www.juniper.net/documentation/us/en/software/junos/release-notes/22.4/junos-release-notes-22.4r1/index.html -Michael > -Original Message- > From: juniper-nsp On Behalf Of > Andrey Kostin via juniper-nsp > Sent: Monday, March 18, 2024 7:37 AM > To: Joe Horton > Cc: Juniper Nsp > Subject: Re: [j-nsp] Juniper publishes Release notes as pdf > > Thanks, Joe. > > Right, pdf only for SR releases has been a while, but not very long, the > change happened just few months ago. My personal preference would be to > read html that can adapt to screen size, etc. Imo the value of pdf is to > be able to print a paper copy, but it's hard to imagine that somebody > would print release notes in the present time. > > Kind regards, > Andrey > > Joe Horton via juniper-nsp писал(а) 2024-03-15 21:36: > > Correct. > > > > SR releases – PDF only, and I think it has been that way a while. > > R release – html/web based + PDF > > > > And understand, I’ll pass along the feedback to the docs team. > > > > Joe > > > > > ___ > juniper-nsp mailing list juniper-nsp@puck.nether.net > https://urldefense.com/v3/__https://puck.nether.net/mailman/listinfo/junip > er- > nsp__;!!Mak6IKo!KwspzhVpA4H07DE07WwOX7O2Mcz02FfnRg1MEuPyGll8k > uhy28xOFgROPz-6ojKOiKfVJ4bNsRh3o85dwy4jnaE8Nzc$ ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
Re: [j-nsp] Juniper publishes Release notes as pdf
Thanks, Joe. Right, pdf only for SR releases has been a while, but not very long, the change happened just few months ago. My personal preference would be to read html that can adapt to screen size, etc. Imo the value of pdf is to be able to print a paper copy, but it's hard to imagine that somebody would print release notes in the present time. Kind regards, Andrey Joe Horton via juniper-nsp писал(а) 2024-03-15 21:36: Correct. SR releases – PDF only, and I think it has been that way a while. R release – html/web based + PDF And understand, I’ll pass along the feedback to the docs team. Joe ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
Re: [j-nsp] Juniper publishes Release notes as pdf
Correct. SR releases – PDF only, and I think it has been that way a while. R release – html/web based + PDF And understand, I’ll pass along the feedback to the docs team. Joe Juniper Business Use Only From: juniper-nsp on behalf of Olivier Benghozi via juniper-nsp Date: Friday, March 15, 2024 at 7:49 PM To: Juniper Nsp Subject: Re: [j-nsp] Juniper publishes Release notes as pdf [External Email. Be cautious of content] Hi Joe, Some more details: A PDF ? OK. A properly formatted PDF? Much better. About regular release notes: they are not available via web for the most recent Service releases. Le ven. 15 mars 2024 à 19:50, Joe Horton a écrit : > SR (service release) release notes have been PDF for a while. > > Regular release notes are still available via web as previously. > > > > I’ll gladly pass along the feedback as well that SR notes need improvement. > > > > Joe > > > > Juniper Business Use Only > > *From: *juniper-nsp on behalf of > Olivier Benghozi via juniper-nsp > *Date: *Friday, March 15, 2024 at 1:16 PM > *To: *Juniper Nsp > *Subject: *Re: [j-nsp] Juniper publishes Release notes as pdf > > [External Email. Be cautious of content] > > > That's right, it's ridiculous: the person in charge actually just clicks on > «print as PDF» from its Juniper_internal_only_web_access, and uses the > Portrait format instead of Landscape: therefore some part of the text is > frequently eaten on the right of the document. > No proofreading, no check, no nothing... > > > Le ven. 15 mars 2024 à 18:41, Andrey Kostin via juniper-nsp < > juniper-nsp@puck.nether.net> a écrit : > > > > > Hi Juniper-NSP readers, > > > > Did anybody mention that recent Junos Release Notes are now published as > > pdf, instead of usual web page? > > Here is the example: > > https://supportportal.juniper.net/s/article/22-2R3-S3-SRN?language=en_US > > What do you think about it? > > For me, it's very inconvenient. To click links to PR or copy one > > paragraph I now have to download the pdf and open it in Acrobat. Please > > chime in and maybe our voices will be heard. > > > > -- *Ce message et toutes les pièces jointes (ci-après le "message") sont établis à l’intention exclusive des destinataires désignés. Il contient des informations confidentielles et pouvant être protégé par le secret professionnel. Si vous recevez ce message par erreur, merci d'en avertir immédiatement l'expéditeur et de détruire le message. Toute utilisation de ce message non conforme à sa destination, toute diffusion ou toute publication, totale ou partielle, est interdite, sauf autorisation expresse de l'émetteur* ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://urldefense.com/v3/__https://puck.nether.net/mailman/listinfo/juniper-nsp__;!!NEt6yMaO-gk!BRN-lg2KOVHXl9ti-UJ8aRf94PorGcMkhuKNNwuMB7XPQQxwooYb_LF1k9eRGmf_U5qHlmCqjnkEtCXtrVScFSFX$<https://urldefense.com/v3/__https:/puck.nether.net/mailman/listinfo/juniper-nsp__;!!NEt6yMaO-gk!BRN-lg2KOVHXl9ti-UJ8aRf94PorGcMkhuKNNwuMB7XPQQxwooYb_LF1k9eRGmf_U5qHlmCqjnkEtCXtrVScFSFX$> ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
Re: [j-nsp] Juniper publishes Release notes as pdf
Hi Joe, Some more details: A PDF ? OK. A properly formatted PDF? Much better. About regular release notes: they are not available via web for the most recent Service releases. Le ven. 15 mars 2024 à 19:50, Joe Horton a écrit : > SR (service release) release notes have been PDF for a while. > > Regular release notes are still available via web as previously. > > > > I’ll gladly pass along the feedback as well that SR notes need improvement. > > > > Joe > > > > Juniper Business Use Only > > *From: *juniper-nsp on behalf of > Olivier Benghozi via juniper-nsp > *Date: *Friday, March 15, 2024 at 1:16 PM > *To: *Juniper Nsp > *Subject: *Re: [j-nsp] Juniper publishes Release notes as pdf > > [External Email. Be cautious of content] > > > That's right, it's ridiculous: the person in charge actually just clicks on > «print as PDF» from its Juniper_internal_only_web_access, and uses the > Portrait format instead of Landscape: therefore some part of the text is > frequently eaten on the right of the document. > No proofreading, no check, no nothing... > > > Le ven. 15 mars 2024 à 18:41, Andrey Kostin via juniper-nsp < > juniper-nsp@puck.nether.net> a écrit : > > > > > Hi Juniper-NSP readers, > > > > Did anybody mention that recent Junos Release Notes are now published as > > pdf, instead of usual web page? > > Here is the example: > > https://supportportal.juniper.net/s/article/22-2R3-S3-SRN?language=en_US > > What do you think about it? > > For me, it's very inconvenient. To click links to PR or copy one > > paragraph I now have to download the pdf and open it in Acrobat. Please > > chime in and maybe our voices will be heard. > > > > -- *Ce message et toutes les pièces jointes (ci-après le "message") sont établis à l’intention exclusive des destinataires désignés. Il contient des informations confidentielles et pouvant être protégé par le secret professionnel. Si vous recevez ce message par erreur, merci d'en avertir immédiatement l'expéditeur et de détruire le message. Toute utilisation de ce message non conforme à sa destination, toute diffusion ou toute publication, totale ou partielle, est interdite, sauf autorisation expresse de l'émetteur* ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
Re: [j-nsp] Juniper publishes Release notes as pdf
SR (service release) release notes have been PDF for a while. Regular release notes are still available via web as previously. I’ll gladly pass along the feedback as well that SR notes need improvement. Joe Juniper Business Use Only From: juniper-nsp on behalf of Olivier Benghozi via juniper-nsp Date: Friday, March 15, 2024 at 1:16 PM To: Juniper Nsp Subject: Re: [j-nsp] Juniper publishes Release notes as pdf [External Email. Be cautious of content] That's right, it's ridiculous: the person in charge actually just clicks on «print as PDF» from its Juniper_internal_only_web_access, and uses the Portrait format instead of Landscape: therefore some part of the text is frequently eaten on the right of the document. No proofreading, no check, no nothing... Le ven. 15 mars 2024 à 18:41, Andrey Kostin via juniper-nsp < juniper-nsp@puck.nether.net> a écrit : > > Hi Juniper-NSP readers, > > Did anybody mention that recent Junos Release Notes are now published as > pdf, instead of usual web page? > Here is the example: > https://supportportal.juniper.net/s/article/22-2R3-S3-SRN?language=en_US > What do you think about it? > For me, it's very inconvenient. To click links to PR or copy one > paragraph I now have to download the pdf and open it in Acrobat. Please > chime in and maybe our voices will be heard. > -- *Ce message et toutes les pièces jointes (ci-après le "message") sont établis à l’intention exclusive des destinataires désignés. Il contient des informations confidentielles et pouvant être protégé par le secret professionnel. Si vous recevez ce message par erreur, merci d'en avertir immédiatement l'expéditeur et de détruire le message. Toute utilisation de ce message non conforme à sa destination, toute diffusion ou toute publication, totale ou partielle, est interdite, sauf autorisation expresse de l'émetteur* ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://urldefense.com/v3/__https://puck.nether.net/mailman/listinfo/juniper-nsp__;!!NEt6yMaO-gk!CRYVOKgAya1AKH0DzH5JCGot-VJGdyu7M6AfFn2MXgNGVuRrJoAq816Ty6IT-JcGtiLagzKT12vAQ6OZht2h2Fpz$<https://urldefense.com/v3/__https:/puck.nether.net/mailman/listinfo/juniper-nsp__;!!NEt6yMaO-gk!CRYVOKgAya1AKH0DzH5JCGot-VJGdyu7M6AfFn2MXgNGVuRrJoAq816Ty6IT-JcGtiLagzKT12vAQ6OZht2h2Fpz$> ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
Re: [j-nsp] Juniper publishes Release notes as pdf
That's right, it's ridiculous: the person in charge actually just clicks on «print as PDF» from its Juniper_internal_only_web_access, and uses the Portrait format instead of Landscape: therefore some part of the text is frequently eaten on the right of the document. No proofreading, no check, no nothing... Le ven. 15 mars 2024 à 18:41, Andrey Kostin via juniper-nsp < juniper-nsp@puck.nether.net> a écrit : > > Hi Juniper-NSP readers, > > Did anybody mention that recent Junos Release Notes are now published as > pdf, instead of usual web page? > Here is the example: > https://supportportal.juniper.net/s/article/22-2R3-S3-SRN?language=en_US > What do you think about it? > For me, it's very inconvenient. To click links to PR or copy one > paragraph I now have to download the pdf and open it in Acrobat. Please > chime in and maybe our voices will be heard. > -- *Ce message et toutes les pièces jointes (ci-après le "message") sont établis à l’intention exclusive des destinataires désignés. Il contient des informations confidentielles et pouvant être protégé par le secret professionnel. Si vous recevez ce message par erreur, merci d'en avertir immédiatement l'expéditeur et de détruire le message. Toute utilisation de ce message non conforme à sa destination, toute diffusion ou toute publication, totale ou partielle, est interdite, sauf autorisation expresse de l'émetteur* ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp
[j-nsp] Juniper publishes Release notes as pdf
Hi Juniper-NSP readers, Did anybody mention that recent Junos Release Notes are now published as pdf, instead of usual web page? Here is the example: https://supportportal.juniper.net/s/article/22-2R3-S3-SRN?language=en_US What do you think about it? For me, it's very inconvenient. To click links to PR or copy one paragraph I now have to download the pdf and open it in Acrobat. Please chime in and maybe our voices will be heard. Kind regards, Andrey Kostin ___ juniper-nsp mailing list juniper-nsp@puck.nether.net https://puck.nether.net/mailman/listinfo/juniper-nsp