{"action":"created","issue":{"url":"https://api.github.com/repos/kubernetes/community/issues/484","repository_url":"https://api.github.com/repos/kubernetes/community","labels_url":"https://api.github.com/repos/kubernetes/community/issues/484/labels{/name}","comments_url":"https://api.github.com/repos/kubernetes/community/issues/484/comments","events_url":"https://api.github.com/repos/kubernetes/community/issues/484/events","html_url":"https://github.com/kubernetes/community/issues/484","id":217437694,"node_id":"MDU6SXNzdWUyMTc0Mzc2OTQ=","number":484,"title":"New release notes process and guidance","user":{"login":"bgrant0607","id":7725777,"node_id":"MDQ6VXNlcjc3MjU3Nzc=","avatar_url":"https://avatars1.githubusercontent.com/u/7725777?v=4","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"labels":[{"id":778120885,"node_id":"MDU6TGFiZWw3NzgxMjA4ODU=","url":"https://api.github.com/repos/kubernetes/community/labels/lifecycle/frozen","name":"lifecycle/frozen","color":"d3e2f0","default":false},{"id":653942886,"node_id":"MDU6TGFiZWw2NTM5NDI4ODY=","url":"https://api.github.com/repos/kubernetes/community/labels/sig/contributor-experience","name":"sig/contributor-experience","color":"d2b48c","default":false},{"id":670265417,"node_id":"MDU6TGFiZWw2NzAyNjU0MTc=","url":"https://api.github.com/repos/kubernetes/community/labels/sig/pm","name":"sig/pm","color":"d2b48c","default":false},{"id":653942901,"node_id":"MDU6TGFiZWw2NTM5NDI5MDE=","url":"https://api.github.com/repos/kubernetes/community/labels/sig/release","name":"sig/release","color":"d2b48c","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":8,"created_at":"2017-03-28T03:26:50Z","updated_at":"2018-06-25T07:28:25Z","closed_at":null,"author_association":"MEMBER","body":"Forked from https://github.com/kubernetes/features/pull/204 and other discussions.\r\n\r\nWe put our release notes here:\r\nhttps://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md\r\n\r\nThe original release-note mechanism design and release changelog template were described here:\r\nhttps://github.com/kubernetes/community/blob/master/contributors/design-proposals/release-notes.md\r\n\r\nA decision about whether a PR should generate a release note was made merge-blocking in the PR workflow, as described here:\r\nhttps://github.com/kubernetes/community/blob/master/contributors/devel/pull-requests.md#release-notes\r\n\r\nWe subsequently made it possible to both set the labels automatically from the PR template, if properly filled out, and created /release-note commands to enable non-maintainers to set the labels, as described here:\r\n\r\nhttps://github.com/kubernetes/community/blob/master/contributors/devel/pull-request-commands.md#set-release-notes\r\n\r\nWe also subsequently developed the features repo and process, from which some of the release notes are created by hand, based on which features target the release.\r\n\r\nIt's clear that the release-note mechanism in the kubernetes repo is causing too much contributor friction, that most people don't know what deserves a release note (e.g., examples, tests, and build scripts shouldn't have release notes) or what would make a good release note, and that the features repo provides another potential mechanism for surfacing release notes.\r\n\r\n** What is the purpose of release notes **\r\n\r\nRelease notes give our users a heads-up about what is coming when they install or upgrade to a particular release of Kubernetes.\r\n\r\nThey are not primarily for contributors to Kubernetes, who could look at the PRs associated with a particular git tag.\r\n\r\n** What deserves a release note **\r\n\r\nAny significant user- or admin-visible change. It could be an API change, a CLI change, a UI change, a configuration schema change, a behavioral change, a change in non-functional attributes such as efficiency or availability, availability of a new platform, advance warning about deprecation of a feature, etc.\r\n\r\nFixes of issues previously cited as Known Issues due to the breadth and/or severity of their impact also qualify, as do CVE fixes.\r\n\r\n** What doesn't deserve a release note **\r\n\r\nNot exhaustive:\r\n* tests (e.g., `Fix TestServiceAlloc flakes`)\r\n* examples\r\n* build infrastructure\r\n* fixes of unreleased bugs\r\n* fixes of minor bugs\r\n* ideally, incomplete/inaccessible features\r\n\r\n** What should be in a release note **\r\n\r\n* Clear, concise description of the change\r\n  * Explicitly name affected API or configuration fields, CLI commands or flags, relevant feature, measured non-functional changes, etc., in user-visible terms (e.g., using json field names rather than Go field names)\r\n  * State whether it was added, removed, changed, deprecated, advanced in maturity (alpha, beta, stable), etc.\r\n  * Link to relevant user documentation about the feature or, if non-trivial actions are required, about the change itself (yes, docs shouldn't be an afterthought)\r\n  * Make the information relevant to and actionable by admins or users, if necessary.  (For example, `Fix GCI mounter issue` is not.)\r\n* Appropriately categorized\r\n  * Feature\r\n  * Action required\r\n  * Deprecation announcement\r\n  * Other notable change, categorized by component or feature area (not by contributor concepts such as SIG or code repo)\r\n\r\nWe also need some way of reporting known issues left unaddressed in the release, and recommended versions of dependencies (e.g., etcd, container runtimes), along with their known issues.\r\n\r\ncc @idvoretskyi @calebamiles @fejta @pwittrock "},"comment":{"url":"https://api.github.com/repos/kubernetes/community/issues/comments/399858103","html_url":"https://github.com/kubernetes/community/issues/484#issuecomment-399858103","issue_url":"https://api.github.com/repos/kubernetes/community/issues/484","id":399858103,"node_id":"MDEyOklzc3VlQ29tbWVudDM5OTg1ODEwMw==","user":{"login":"justaugustus","id":567897,"node_id":"MDQ6VXNlcjU2Nzg5Nw==","avatar_url":"https://avatars3.githubusercontent.com/u/567897?v=4","gravatar_id":"","url":"https://api.github.com/users/justaugustus","html_url":"https://github.com/justaugustus","followers_url":"https://api.github.com/users/justaugustus/followers","following_url":"https://api.github.com/users/justaugustus/following{/other_user}","gists_url":"https://api.github.com/users/justaugustus/gists{/gist_id}","starred_url":"https://api.github.com/users/justaugustus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/justaugustus/subscriptions","organizations_url":"https://api.github.com/users/justaugustus/orgs","repos_url":"https://api.github.com/users/justaugustus/repos","events_url":"https://api.github.com/users/justaugustus/events{/privacy}","received_events_url":"https://api.github.com/users/justaugustus/received_events","type":"User","site_admin":false},"created_at":"2018-06-25T07:28:24Z","updated_at":"2018-06-25T07:28:24Z","author_association":"MEMBER","body":"Adding RT Release Notes peeps from 1.10, 1.11, 1.12 to provide additional color and maybe get a volunteer to document the process.\r\n\r\n/cc @nickchase @qedrakmar @marpaia @dstrebel @onyiny-ang"}}
{"actor":{"display_login":"justaugustus"}}