CJCombrink commented on PR #20: URL: https://github.com/apache/thrift-website/pull/20#issuecomment-4404006697
I am unfortunately someone that reads more changelogs than any person should probably do and I appreciate all the effort that @Jens-G (and everyone involved) do to create proper and complete changelogs. As a developer that has contributed to thrift the git changes list as linked is interesting and insightful but as a user of Thrift (and any other library or product) they add little value, especially since thrift has many components and technologies/languages, of only 3 or 4 that I care about. Example, looking at the link provided: "[Fix received keyword](https://github.com/apache/thrift/commit/02b02df2ce6d3f4520751b41d5cc31d351fe49cf)" says absolutely nothing: Yes better git hygiene can improve this but there are always commits going in that are irrelevant to the end user so they don't belong on the CHANGELOG. The thrift project's approach of formal tickets in Jira has a distinct feature where it filters that out. Now it takes hard work and effort to make sure the tickets correspond to the history, since as you say the history is the only source of truth, so there is room for improvement there, but personally I don't think just telling users to "go look at the history" is ideal. _I manage changelogs in our company and find it challenging to ensure that the tickets (we also use jira) actually represents what went into git (bitbucket), so hoping (and exploring) for the day where AI can take over that work_ My 2c -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
