Re: [j-nsp] Juniper publishes Release notes as pdf

2024-03-18 Thread Tobias Heister via 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  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

2024-03-18 Thread 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


Re: [j-nsp] Juniper publishes Release notes as pdf

2024-03-18 Thread Andrey Kostin via 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


Re: [j-nsp] Juniper publishes Release notes as pdf

2024-03-15 Thread Joe Horton via 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  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

2024-03-15 Thread Olivier Benghozi via 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  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

2024-03-15 Thread Joe Horton via 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  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

2024-03-15 Thread Olivier Benghozi via juniper-nsp
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

2024-03-15 Thread Andrey Kostin via juniper-nsp



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