[j-nsp] Juniper publishes Release notes as pdf

[Tobias Heister]

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