devonestes / assertions

Helpful assertions for ExUnit
MIT License
142 stars 29 forks source link

Add CHANGELOG and create releases #6

Closed milmazz closed 5 years ago

milmazz commented 5 years ago

Hey @devonestes, I hope you're doing well and thanks for maintaining this amazing helper. After a recent upgrade to 0.14.1, assertions catch some errors (which is nice) on a few unit tests, at first I was confused because the whole suite was working correctly before, anyway, I tried finding the CHANGELOG file to read more information about recent changes, I didn't find that file for reference, then I tried looking at your release page, nothing there too. Then I checked the commit logs and finally found that you recently fixed the assert_map_in_list/3 function, from there was easy to know why the test suite was failing.

So, my suggestion is to include a CHANGELOG file in the project, here you can find more information why keeping a CHANGELOG file is important, and for every release put some information about the changes on that release. Another benefit from doing this is that bots like dependabot (which now we use on the team) parses that information, here you can find an example from the sentry package:

Screen Shot 2019-06-13 at 5 24 47 PM

devonestes commented 5 years ago

Fixed in #7