Feature #5074
openStandard release notes URLs to facilitate GUI viewing before upgrade
0%
Description
The GUI indicates whether an upgrade is available, but doesn't provide a way to see the summary or detailed release notes for various versions, or a list of releases. So a user who is told an upgrade is available, can't quickly and easily see what the upgrade involves, or (if they would "jump" an upgrade eg 2.2.2 -> 2.4) any information about the interim upgrades.
It's in everyone's interest that upgrading is easy, so I looked to see what's needed to add this. The biggest problem seems to be that there don't seem to be standard URLs to find summary and detail version release notes, or a URL which lists the previous release versions in "bare" format. They're put on the forum but that's got an unpredictable URL and cluttered by forum formatting.
So this is a request, could a schema be used so that there is a URL where the router can go to grab the bare list of releases, and the summary and detail release notes for these in a standardised URL? I'm not asking for any change to the router code, but just standard URLs to be designated so that if/when release note info viewing is added to the upgrade page (by myself or anyone else who wants to), the URLs needed to make it work are set up and working.
Thanks :)
Updated by Stilez y about 9 years ago
(Sorry, for forum read "blog", but the same applies)
Updated by Jim Pingle about 9 years ago
We already have a "standard" URL for them on the doc wiki:
https://doc.pfsense.org/index.php/<release number>_New_Features_and_Changes
It's been that way since 2.0
Examples:
https://doc.pfsense.org/index.php/2.1_New_Features_and_Changes
https://doc.pfsense.org/index.php/2.1.5_New_Features_and_Changes
https://doc.pfsense.org/index.php/2.2_New_Features_and_Changes
https://doc.pfsense.org/index.php/2.2.4_New_Features_and_Changes
Full list is at https://doc.pfsense.org/index.php/Versions_of_pfSense_and_FreeBSD -- last column has a link to these pages.
Could either link there or attempt to pull in the text somehow.
The mediawiki markup is still readable as plain text if accessed directly, for example:
https://doc.pfsense.org/index.php?title=2.2.4_New_Features_and_Changes&action=raw
Updated by router owner over 1 year ago
Even a static link to https://docs.netgate.com/pfsense/en/latest/releases/index.html on the "update available" page would be a usability improvement