Releases is a sphinx extension designed to help you keep a source control friendly, merge friendly changelog file & turn it into useful, human readable html output.

specifically:

* the source format (kept in your sphinx tree as ``changelog.rst``) is a
stream-like timeline that plays well with source control & only requires
one entry per change (even for changes that exist in multiple release
lines).
* the output (when you have the extension installed and run your sphinx
build command) is a traditional looking changelog page with a section for
every release; multi-release issues are copied automatically into each
release.
* by default, feature and support issues are only displayed under feature
releases, and bugs are only displayed under bugfix releases. this can be
overridden on a per-issue basis.
this package contains the documentation for releases.