Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add upgrade guide for 2.19.4 #496

Merged
merged 1 commit into from
Dec 9, 2016

Conversation

daniel-beck
Copy link
Contributor

Not sure whether some of these are relevant enough.

@olivergondza @oleg-nenashev WDYT?

@oleg-nenashev
Copy link
Contributor

Also worth mentioning https://issues.jenkins-ci.org/browse/JENKINS-38721 and https://issues.jenkins-ci.org/browse/JENKINS-37282 (regression in 2.14, which has been fixed only in 2.19.4)

@daniel-beck
Copy link
Contributor Author

daniel-beck commented Dec 9, 2016

We do have a changelog already. The idea is to point out not just bug fixes all over here, but add information relevant to users specifically when upgrading.

  • The problem with JNLP agent protocols not storing (or loading) the config -- point out that their previous config changes may be ineffective.
  • slaveAgentPort is important both because it introduced a new feature in a .4, and because it may now unexpectedly be effective despite being set long ago (e.g. when spinning up instances by script).
  • Text boxes -- at least on OS X, horizontal scrolling doesn't show very obviously in some configurations, so point this out. Also, no need for the perhaps automatically applied line length workaround anymore.

So there's clearly some use in pointing these out for administrators doing an upgrade. But I don't see any extra information need beyond changelog for those two bugs.

Even the last two I listed, which I'm not sure about as I wrote in the original comment, are of the "not obvious brokenness but you may be able to unlearn a learned behavior you applied as workaround" type -- similar to when I pointed out that people can now use the back button in the browser a few releases back.

@oleg-nenashev
Copy link
Contributor

Agreed

@daniel-beck
Copy link
Contributor Author

Can always be optimized later, merging. Thanks @oleg-nenashev

@daniel-beck daniel-beck merged commit 5202284 into jenkins-infra:master Dec 9, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants