{"action":"created","issue":{"url":"https://api.github.com/repos/tj/git-extras/issues/413","labels_url":"https://api.github.com/repos/tj/git-extras/issues/413/labels{/name}","comments_url":"https://api.github.com/repos/tj/git-extras/issues/413/comments","events_url":"https://api.github.com/repos/tj/git-extras/issues/413/events","html_url":"https://github.com/tj/git-extras/pull/413","id":98853810,"number":413,"title":"changelog: wording in docs","user":{"login":"nicolaiskogheim","id":2117636,"avatar_url":"https://avatars.githubusercontent.com/u/2117636?v=3","gravatar_id":"","url":"https://api.github.com/users/nicolaiskogheim","html_url":"https://github.com/nicolaiskogheim","followers_url":"https://api.github.com/users/nicolaiskogheim/followers","following_url":"https://api.github.com/users/nicolaiskogheim/following{/other_user}","gists_url":"https://api.github.com/users/nicolaiskogheim/gists{/gist_id}","starred_url":"https://api.github.com/users/nicolaiskogheim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nicolaiskogheim/subscriptions","organizations_url":"https://api.github.com/users/nicolaiskogheim/orgs","repos_url":"https://api.github.com/users/nicolaiskogheim/repos","events_url":"https://api.github.com/users/nicolaiskogheim/events{/privacy}","received_events_url":"https://api.github.com/users/nicolaiskogheim/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-08-03T22:59:01Z","updated_at":"2015-08-03T23:27:12Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/tj/git-extras/pulls/413","html_url":"https://github.com/tj/git-extras/pull/413","diff_url":"https://github.com/tj/git-extras/pull/413.diff","patch_url":"https://github.com/tj/git-extras/pull/413.patch"},"body":"I think this is a slightly better way to put it.\r\n\r\nAlso, I think we could remove most of the examples as many of them are very trivial and well explained in the options section anyway. With me on that?"},"comment":{"url":"https://api.github.com/repos/tj/git-extras/issues/comments/127430634","html_url":"https://github.com/tj/git-extras/pull/413#issuecomment-127430634","issue_url":"https://api.github.com/repos/tj/git-extras/issues/413","id":127430634,"user":{"login":"markeissler","id":2679087,"avatar_url":"https://avatars.githubusercontent.com/u/2679087?v=3","gravatar_id":"","url":"https://api.github.com/users/markeissler","html_url":"https://github.com/markeissler","followers_url":"https://api.github.com/users/markeissler/followers","following_url":"https://api.github.com/users/markeissler/following{/other_user}","gists_url":"https://api.github.com/users/markeissler/gists{/gist_id}","starred_url":"https://api.github.com/users/markeissler/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/markeissler/subscriptions","organizations_url":"https://api.github.com/users/markeissler/orgs","repos_url":"https://api.github.com/users/markeissler/repos","events_url":"https://api.github.com/users/markeissler/events{/privacy}","received_events_url":"https://api.github.com/users/markeissler/received_events","type":"User","site_admin":false},"created_at":"2015-08-03T23:27:12Z","updated_at":"2015-08-03T23:27:12Z","body":"I disagree. The wording was meant to explain the potentially confusing legacy behavior where an existing Changelog is appended automatically to the output. I decided to preserve that behavior (along with all other legacy behavior) since git-changelog is often triggered from much larger/comprehensive automated build/release scripts--that is, I didn't want to be the one to break someone's build script. The --prune flag was introduced to override that legacy behavior (if it wasn't for legacy support the --prune mode would have been the default).\r\n\r\nAs for __ignores__ vs __overrides__, I'm not sure one is better than the other.\r\n\r\nFinally, I don't really see the point of removing examples if they promote clarity."}}