Mailing List Archive

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

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 <juniper-nsp-bounces@puck.nether.net> on behalf of Olivier Benghozi via juniper-nsp <juniper-nsp@puck.nether.net>
Date: Friday, March 15, 2024 at 1:16?PM
To: Juniper Nsp <juniper-nsp@puck.nether.net>
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

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 <jhorton@juniper.net> 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 <juniper-nsp-bounces@puck.nether.net> on behalf of
> Olivier Benghozi via juniper-nsp <juniper-nsp@puck.nether.net>
> *Date: *Friday, March 15, 2024 at 1:16?PM
> *To: *Juniper Nsp <juniper-nsp@puck.nether.net>
> *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

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 <juniper-nsp-bounces@puck.nether.net> on behalf of Olivier Benghozi via juniper-nsp <juniper-nsp@puck.nether.net>
Date: Friday, March 15, 2024 at 7:49?PM
To: Juniper Nsp <juniper-nsp@puck.nether.net>
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 <jhorton@juniper.net> 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 <juniper-nsp-bounces@puck.nether.net> on behalf of
> Olivier Benghozi via juniper-nsp <juniper-nsp@puck.nether.net>
> *Date: *Friday, March 15, 2024 at 1:16?PM
> *To: *Juniper Nsp <juniper-nsp@puck.nether.net>
> *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

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

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 <juniper-nsp-bounces@puck.nether.net> On Behalf Of
> Andrey Kostin via juniper-nsp
> Sent: Monday, March 18, 2024 7:37 AM
> To: Joe Horton <jhorton@juniper.net>
> Cc: Juniper Nsp <juniper-nsp@puck.nether.net>
> 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

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 <juniper-nsp-bounces@puck.nether.net> On Behalf Of
>> Andrey Kostin via juniper-nsp
>> Sent: Monday, March 18, 2024 7:37 AM
>> To: Joe Horton <jhorton@juniper.net>
>> Cc: Juniper Nsp <juniper-nsp@puck.nether.net>
>> 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