Format changelog closer to keep a changelog format

Author: srittau

CHANGELOG.md

@@ -1,45 +1,45 @@
-## Unreleased
+# Changelog for python-asserts
 
-### Incompatible Changes
+python-asserts adheres to [semantic versioning](https://semver.org/).
 
-- Drop support for Python 3.7.
+## [Unreleased]
 
-## News in asserts 0.12.0
+### Removed
 
-### Incompatible Changes
+- Drop support for Python 3.7.
 
-- Drop support for Python 3.6.
+## [0.12.0]
 
-### API Additions
+### Added
 
 - Add `assert_not_regex()`.
 
-### Other Changes
+### Changed
 
 - Modernize the type stubs.
 
-## News in asserts 0.11.1
+### Removed
 
-### API Additions
+- Drop support for Python 3.6.
+
+## [0.11.1]
+
+### Added
 
 - `assert_json_subset()` can now check for the existence or non-existence
   of object members using the new `Exists` helper.
 - Non-string (or `Exists`) object member names in the first argument to
   `assert_json_subset()` now raise a `TypeError`.
 
-## News in asserts 0.11.0
+## [0.11.0]
 
-### API-Incompatible Changes
+### Removed
 
 - Drop support for Python 2.7 and 3.5.
 
-## News in asserts 0.10.0
-
-### API-Incompatible Changes
+## [0.10.0]
 
-- Drop support for Python 3.4.
-
-### API Additions
+### Added
 
 - `AssertRaisesContext` and `AssertWarnsContext` now return themselves
   when `__enter__()` is called. By extension it now easier to call
@@ -60,67 +60,77 @@ with assert_raises(KeyError) as context:
 assert_equal("expected message", str(context.exc_val))
 ```
 
-## News in asserts 0.9.1
+### Removed
+
+- Drop support for Python 3.4.
 
-### Improvements
+## [0.9.1]
+
+### Changed
 
 - `AssertRaisesContext` and sub-classes are now generic over the
   exception type.
 
-## News in asserts 0.9.0
+## [0.9.0]
 
-### API Additions
+### Added
 
 - Add `assert_json_subset()`.
 
-## News in asserts 0.8.6
+## [0.8.6]
 
-### Improvements
+### Added
 
 - Add support for Python 3.7 (contributed by Frank Niessink).
 
-## News in asserts 0.8.5
+## [0.8.5]
 
-### API Additions
+### Added
 
 - Add `assert_dict_equal()`.
 - Add `assert_dict_superset()`.
 
-### Improvements
+### Changed
 
 - `assert_equal()`: Use `assert_dict_equal()` if applicable.
 
-## News in asserts 0.8.4
+## [0.8.4]
 
-### Improvements
+### Changed
 
 - `fail()` is now marked with `NoReturn` in type stub.
 
-### Bug Fixes
+### Fixed
 
 - Improve type annotations for Python 2.
 
-## News in asserts 0.8.3
+## [0.8.3]
 
-### Bug Fixes
+### Fixed
 
 - Fix type signature of `AssertRaisesContext.__exit__()`.
 
-## News in asserts 0.8.2
+## [0.8.2]
 
-### Improvements
+### Added
 
 - Add a py.typed file to signal that this package supports type hints.
 
-## News in asserts 0.8.1
+## [0.8.1]
 
-### Bug Fixes
+### Fixed
 
 - `assert_raises_regex()`: Handle exceptions without any message correctly.
 
-## News in asserts 0.8.0
+## [0.8.0]
 
-### API-Incompatible Changes
+### Added
+
+- assert_count_equal(): Add `msg_fmt` argument.
+- Add AssertRaisesErrnoContext, AssertRaisesRegexContext, and
+  AssertWarnsRegexContext.
+
+### Changed
 
 - Replace `msg` argument with `msg_fmt` in all assertions (except `fail()`).
   This allows you to customize error messages more easily than before, because
@@ -131,64 +141,61 @@ assert_equal("expected message", str(context.exc_val))
 - assert_almost_equal(), assert_not_almost_equal(): Place msg_fmt as third
   argument.
 
-### API Additions
-
-- assert_count_equal(): Add `msg_fmt` argument.
-- Add AssertRaisesErrnoContext, AssertRaisesRegexContext, and
-  AssertWarnsRegexContext.
+## [0.7.3]
 
-## News in asserts 0.7.3
-
-### API Additions
+### Added
 
 - Add assert_not_almost_equal().
 
-### Improvements
+### Changed
 
 - assert_almost_equal(): Raise ValueError if diff <= 0.
 
-### Bug Fixes
+### Fixed
 
 - assert_almost_equal() would never fail if a delta was supplied and the
   second number was smaller than the first.
 - Use fail() instead of raise AssertionError in a few assertions.
 
-## News in asserts 0.7.2
+## [0.7.2]
 
-### API Additions
+### Added
 
 - Add assert_warns() and assert_warns_regex().
 
-## News in asserts 0.7.1
+## [0.7.1]
 
-- Distribute as wheel.
-- asserts is now a package, instead of a module.
+### Changed
 
-## News in asserts 0.7.0
+- Distribute a wheel.
+- asserts is now a package, instead of a module.
 
-- Add a stub file.
+## [0.7.0]
 
-### API Additions
+### Added
 
+- Add a stub file.
 - Add assert_count_equal().
 
-## News in asserts 0.6
+## [0.6]
 
-### API Additions
+### Added
 
 - Add assert_less(), assert_less_equal(), assert_greater(), and
   assert_greater_equal().
 - Add assert_not_is_instance().
 
-### Improvements
+### Changed
 
 - assert_datetime_about_now()/assert_datetime_about_now_utc(): Handle
   comparison with None more gracefully.
 
-## News in asserts 0.5.1
+## [0.5.1]
+
+### Added
 
 - Add the LICENSE file to the distribution.
 
-## News in asserts 0.5
+## [0.5]
 
 Initial release.