{"action":"created","issue":{"url":"https://api.github.com/repos/rust-lang/cargo/issues/2334","repository_url":"https://api.github.com/repos/rust-lang/cargo","labels_url":"https://api.github.com/repos/rust-lang/cargo/issues/2334/labels{/name}","comments_url":"https://api.github.com/repos/rust-lang/cargo/issues/2334/comments","events_url":"https://api.github.com/repos/rust-lang/cargo/issues/2334/events","html_url":"https://github.com/rust-lang/cargo/pull/2334","id":129922381,"number":2334,"title":"Metadata: Add changelog field","user":{"login":"dbrgn","id":105168,"avatar_url":"https://avatars.githubusercontent.com/u/105168?v=3","gravatar_id":"","url":"https://api.github.com/users/dbrgn","html_url":"https://github.com/dbrgn","followers_url":"https://api.github.com/users/dbrgn/followers","following_url":"https://api.github.com/users/dbrgn/following{/other_user}","gists_url":"https://api.github.com/users/dbrgn/gists{/gist_id}","starred_url":"https://api.github.com/users/dbrgn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dbrgn/subscriptions","organizations_url":"https://api.github.com/users/dbrgn/orgs","repos_url":"https://api.github.com/users/dbrgn/repos","events_url":"https://api.github.com/users/dbrgn/events{/privacy}","received_events_url":"https://api.github.com/users/dbrgn/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/rust-lang/cargo/labels/relnotes","name":"relnotes","color":"fad8c7"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2016-01-30T01:02:26Z","updated_at":"2016-02-06T23:15:22Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/rust-lang/cargo/pulls/2334","html_url":"https://github.com/rust-lang/cargo/pull/2334","diff_url":"https://github.com/rust-lang/cargo/pull/2334.diff","patch_url":"https://github.com/rust-lang/cargo/pull/2334.patch"},"body":"Fix #2188.\r\n\r\nThis PR adds a \"changelog\" field to the crate metadata.\r\n\r\nThere are two ways this field could be used: With a file path (like the README) or with an URL (like the documentation).\r\n\r\nI think a changelog is more like documentation than like a README. It contains historic information about the crate. The changelog can be updated later on, if we send the file contents to crates.io these changes won't be integrated. Using an URL would show that it's a \"living document\".\r\n\r\nSending the file contents to crates.io might be interesting in the future, but it can still be added if there's a need for it."},"comment":{"url":"https://api.github.com/repos/rust-lang/cargo/issues/comments/180883557","html_url":"https://github.com/rust-lang/cargo/pull/2334#issuecomment-180883557","issue_url":"https://api.github.com/repos/rust-lang/cargo/issues/2334","id":180883557,"user":{"login":"dbrgn","id":105168,"avatar_url":"https://avatars.githubusercontent.com/u/105168?v=3","gravatar_id":"","url":"https://api.github.com/users/dbrgn","html_url":"https://github.com/dbrgn","followers_url":"https://api.github.com/users/dbrgn/followers","following_url":"https://api.github.com/users/dbrgn/following{/other_user}","gists_url":"https://api.github.com/users/dbrgn/gists{/gist_id}","starred_url":"https://api.github.com/users/dbrgn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dbrgn/subscriptions","organizations_url":"https://api.github.com/users/dbrgn/orgs","repos_url":"https://api.github.com/users/dbrgn/repos","events_url":"https://api.github.com/users/dbrgn/events{/privacy}","received_events_url":"https://api.github.com/users/dbrgn/received_events","type":"User","site_admin":false},"created_at":"2016-02-06T23:15:22Z","updated_at":"2016-02-06T23:15:22Z","body":"> We probably don't want to add this yet unless we do something with it. Just adding a key and hoping we manage it later probably isn't what we want to do right now.\r\n\r\nI agree. But what's the downside of simply showing an URL on crates.io that points  to the changelog?"}}