{"action":"created","issue":{"url":"https://api.github.com/repos/kubernetes/charts/issues/5657","repository_url":"https://api.github.com/repos/kubernetes/charts","labels_url":"https://api.github.com/repos/kubernetes/charts/issues/5657/labels{/name}","comments_url":"https://api.github.com/repos/kubernetes/charts/issues/5657/comments","events_url":"https://api.github.com/repos/kubernetes/charts/issues/5657/events","html_url":"https://github.com/kubernetes/charts/issues/5657","id":324656610,"number":5657,"title":"[stable/*] Create and document charts policy for breaking change upgrades","user":{"login":"scottrigby","id":407675,"avatar_url":"https://avatars2.githubusercontent.com/u/407675?v=4","gravatar_id":"","url":"https://api.github.com/users/scottrigby","html_url":"https://github.com/scottrigby","followers_url":"https://api.github.com/users/scottrigby/followers","following_url":"https://api.github.com/users/scottrigby/following{/other_user}","gists_url":"https://api.github.com/users/scottrigby/gists{/gist_id}","starred_url":"https://api.github.com/users/scottrigby/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/scottrigby/subscriptions","organizations_url":"https://api.github.com/users/scottrigby/orgs","repos_url":"https://api.github.com/users/scottrigby/repos","events_url":"https://api.github.com/users/scottrigby/events{/privacy}","received_events_url":"https://api.github.com/users/scottrigby/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-05-19T20:08:49Z","updated_at":"2018-05-19T20:09:23Z","closed_at":null,"author_association":"MEMBER","body":"Hi everyone,\r\n\r\nAfter @unguiculus reached started a Slack Charts maintainers DM about #5576, an unresolved problem emerged. We don't have a kubernetes/charts policy for how to handle breaking change upgrades.\r\n\r\n## Considerations\r\n\r\nThat PR made it clear we have two main choices:\r\n1. Add logic to the templates for every possible upgrade step (from every past to new version of an app).\r\n    - 🚫 This was deemed to be not only an inelegant way to handle this problem on the whole, but also would make charts more difficult to maintain in the future.\r\n2. Follow semver to denote breaking changes (bump MAJOR version, even if the upstream project's `appVersion` itself did not), and somehow clearly communicate the required upgrade steps to chart users who are upgrading from relevant previous versions to the current one (the steps themselves will vary by application and old/new version).\r\n    - ✅ This is the preferred option.\r\n\r\n## Next steps\r\nWe plan to meet about determining some helpful guidelines about this. Possibilities discussed were UPGRADE_NOTES/CHANGELOG files for charts, or adding a new section to the README (perhaps under new section header such as `Upgrading`, just above `Installing the chart` so users are more likely to see it.\r\n\r\nThe ultimate goal of this issue is to track how we decide upon and document a consistent strategy for communicating additional info about breaking changes to users who want to upgrade from past versions of a chart."},"comment":{"url":"https://api.github.com/repos/kubernetes/charts/issues/comments/390429458","html_url":"https://github.com/kubernetes/charts/issues/5657#issuecomment-390429458","issue_url":"https://api.github.com/repos/kubernetes/charts/issues/5657","id":390429458,"user":{"login":"scottrigby","id":407675,"avatar_url":"https://avatars2.githubusercontent.com/u/407675?v=4","gravatar_id":"","url":"https://api.github.com/users/scottrigby","html_url":"https://github.com/scottrigby","followers_url":"https://api.github.com/users/scottrigby/followers","following_url":"https://api.github.com/users/scottrigby/following{/other_user}","gists_url":"https://api.github.com/users/scottrigby/gists{/gist_id}","starred_url":"https://api.github.com/users/scottrigby/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/scottrigby/subscriptions","organizations_url":"https://api.github.com/users/scottrigby/orgs","repos_url":"https://api.github.com/users/scottrigby/repos","events_url":"https://api.github.com/users/scottrigby/events{/privacy}","received_events_url":"https://api.github.com/users/scottrigby/received_events","type":"User","site_admin":false},"created_at":"2018-05-19T20:09:23Z","updated_at":"2018-05-19T20:09:23Z","author_association":"MEMBER","body":"@unguiculus @viglesiasce @prydonius @mattfarina @lachie83 please let me know if I missed anything."}}
{"actor":{"display_login":"scottrigby"}}