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