{"action":"created","issue":{"url":"https://api.github.com/repos/atom/atom/issues/8240","labels_url":"https://api.github.com/repos/atom/atom/issues/8240/labels{/name}","comments_url":"https://api.github.com/repos/atom/atom/issues/8240/comments","events_url":"https://api.github.com/repos/atom/atom/issues/8240/events","html_url":"https://github.com/atom/atom/issues/8240","id":99310951,"number":8240,"title":"Improving Atom's release notes / changelogs","user":{"login":"mnquintana","id":823545,"avatar_url":"https://avatars.githubusercontent.com/u/823545?v=3","gravatar_id":"","url":"https://api.github.com/users/mnquintana","html_url":"https://github.com/mnquintana","followers_url":"https://api.github.com/users/mnquintana/followers","following_url":"https://api.github.com/users/mnquintana/following{/other_user}","gists_url":"https://api.github.com/users/mnquintana/gists{/gist_id}","starred_url":"https://api.github.com/users/mnquintana/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mnquintana/subscriptions","organizations_url":"https://api.github.com/users/mnquintana/orgs","repos_url":"https://api.github.com/users/mnquintana/repos","events_url":"https://api.github.com/users/mnquintana/events{/privacy}","received_events_url":"https://api.github.com/users/mnquintana/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/atom/atom/labels/atom.io","name":"atom.io","color":"d4c5f9"},{"url":"https://api.github.com/repos/atom/atom/labels/documentation","name":"documentation","color":"c7def8"},{"url":"https://api.github.com/repos/atom/atom/labels/enhancement","name":"enhancement","color":"bfd4f2"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-08-05T22:17:24Z","updated_at":"2015-08-06T17:16:21Z","closed_at":null,"body":"## Challenge\r\n\r\nBeing a very modular project, Atom has a lot of changes happening across a lot of repos. This can make it quite a challenge to keep track of all the changes being made in Atom from version to version. Unfortunately, that has sort of meant that our release notes end up being rather bare-bones summaries of what's changed in any particular version, rather than complete, well, changelogs. In addition, none of our bundled packages or libraries have any release notes at all right now - it's only Atom core. \r\n\r\nI think it's important to publicly document every significant change we make to Atom across all of our repos, which should make it a lot easier for users to know what to expect from each release, and hopefully help prevent surprises like https://github.com/atom/toggle-quotes/commit/8899f00c846d9e1525985f551f79cfb134f1bf5b#commitcomment-12552713 or https://github.com/atom/atom/issues/8226.\r\n\r\n## Proposal\r\n1. Add `CHANGELOG.md` files to each package and library repo (or leverage GitHub Releases)\r\n  - I'm personally :+1: for `CHANGELOG.md` files - they're version-controlled, simple to update, easy to discover, and will be displayed properly in settings-view.\r\n1. Add a `CHANGELOG.md` to atom/atom to be used exclusively for core changes\r\n1. Update them individually with each significant changes as they are made\r\n1. Concatenate and organize all changelogs for atom.io/releases\r\n  - For UI here it might be nice to take some inspiration from [Firefox release notes](https://www.mozilla.org/en-US/firefox/39.0/releasenotes/) - default to the short summary display, and offer a \"view full list of changes\" option for those who really want to dig deeper.\r\n  - Maybe even add the ability to filter by package / library?\r\n1. atom/atom release notes (ie. the notes used in GitHub Releases, rather than the `CHANGELOG.md`) can continue to work as the short summary of what changed.\r\n\r\n/cc @atom/feedback "},"comment":{"url":"https://api.github.com/repos/atom/atom/issues/comments/128448511","html_url":"https://github.com/atom/atom/issues/8240#issuecomment-128448511","issue_url":"https://api.github.com/repos/atom/atom/issues/8240","id":128448511,"user":{"login":"izuzak","id":38924,"avatar_url":"https://avatars.githubusercontent.com/u/38924?v=3","gravatar_id":"","url":"https://api.github.com/users/izuzak","html_url":"https://github.com/izuzak","followers_url":"https://api.github.com/users/izuzak/followers","following_url":"https://api.github.com/users/izuzak/following{/other_user}","gists_url":"https://api.github.com/users/izuzak/gists{/gist_id}","starred_url":"https://api.github.com/users/izuzak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/izuzak/subscriptions","organizations_url":"https://api.github.com/users/izuzak/orgs","repos_url":"https://api.github.com/users/izuzak/repos","events_url":"https://api.github.com/users/izuzak/events{/privacy}","received_events_url":"https://api.github.com/users/izuzak/received_events","type":"User","site_admin":true},"created_at":"2015-08-06T17:16:21Z","updated_at":"2015-08-06T17:16:21Z","body":"This has been on my TODO list for a while -- I think it would be helpful. If someone is interested in working on this, perhaps we can team-up. \r\n\r\nThanks for creating a public issue to track this, @mnquintana. :sparkle: "}}