Right now Jenkins Weekly changelog does not explicitly link upgrade guidelines. For LTS we generate https://jenkins.io/doc/upgrade-guide/, but weekly users have to figure out upgrade steps on their own. I suggest to enhance logic so that we can improve the UX:
changelog HAML puts a banner about upgrade steps if any changelog entry includes a flag
LTS changelog points to upgrade guidelines in the banner
Weekly changelog links upgrade guidelines in pull requests
Later we could generate upgrade guidelines in a a different way so that Weekly and LTS users could query upgrade guidelines between multiple releases. It is out of scope for this issue IMHO
Would be nice to have a "GitHub diff" like feature that aggregates changes and related upgrade guides between any two versions, to answer the question "What do I need to know when updating from X to Y?"
Right now Jenkins Weekly changelog does not explicitly link upgrade guidelines. For LTS we generate https://jenkins.io/doc/upgrade-guide/, but weekly users have to figure out upgrade steps on their own. I suggest to enhance logic so that we can improve the UX:
Later we could generate upgrade guidelines in a a different way so that Weekly and LTS users could query upgrade guidelines between multiple releases. It is out of scope for this issue IMHO