jenkins-infra / jenkins.io

A static site for the Jenkins automation server
https://jenkins.io
Other
318 stars 1.21k forks source link

Jenkins Changelogs: flag changes which may require upgrade steps #2917

Open oleg-nenashev opened 4 years ago

oleg-nenashev commented 4 years ago

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

daniel-beck commented 4 years ago

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?"