{"action":"opened","issue":{"url":"https://api.github.com/repos/mozilla/bleach/issues/180","labels_url":"https://api.github.com/repos/mozilla/bleach/issues/180/labels{/name}","comments_url":"https://api.github.com/repos/mozilla/bleach/issues/180/comments","events_url":"https://api.github.com/repos/mozilla/bleach/issues/180/events","html_url":"https://github.com/mozilla/bleach/issues/180","id":120181731,"number":180,"title":"pypi page and docs should show changes","user":{"login":"willkg","id":820826,"avatar_url":"https://avatars.githubusercontent.com/u/820826?v=3","gravatar_id":"","url":"https://api.github.com/users/willkg","html_url":"https://github.com/willkg","followers_url":"https://api.github.com/users/willkg/followers","following_url":"https://api.github.com/users/willkg/following{/other_user}","gists_url":"https://api.github.com/users/willkg/gists{/gist_id}","starred_url":"https://api.github.com/users/willkg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/willkg/subscriptions","organizations_url":"https://api.github.com/users/willkg/orgs","repos_url":"https://api.github.com/users/willkg/repos","events_url":"https://api.github.com/users/willkg/events{/privacy}","received_events_url":"https://api.github.com/users/willkg/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/mozilla/bleach/labels/docs","name":"docs","color":"0b02e1"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-12-03T14:21:07Z","updated_at":"2015-12-03T14:21:07Z","closed_at":null,"body":"bleach has a `CHANGES` file which lists all the things that happened version-to-version. That's super. However, the contents of that file aren't available in the documentation on readthedocs nor on the PyPI page. This makes it difficult for people who are upgrading from one version of bleach to another to know what changed so they can figure out how it impacts them.\r\n\r\nFurther, we should be marking \"backwards-incompatible\" changes more obviously and explaining the old way and the new way.\r\n\r\nThese changes should be reflected in the release process. If there isn't one of those, then we should add that, too."}}