How to write release notes | Tarantool
Contributing How to write release notes

How to write release notes

Below are some best practices to make changelogs consistent, neat, and human-oriented.

  • Use the past tense to describe changed or fixed behavior.

    Examples

    Fixed false positive panic when yielding in debug hook (gh-5649).

    Fedora 32 is supported now. Added per-commit testing, updated YUM repositories (gh-4966).

  • Use the present tense to describe new behavior.

    Example

    Data changes in read-only mode are now forbidden (gh-5231).

  • Start with a capital letter, end with a period.

Note that these guidelines differ from the best practice for commit message titles that suggests using the imperative mood.

In release notes, use the following Sphinx syntax when referring to a specific version of Tarantool:

Tarantool :tarantool-release:`2.10.0`.
This is a link to the release notes on GitHub.

The result looks like this:

Tarantool v. 2.10.0. This is a link to the release notes on GitHub.
Found what you were looking for?
Feedback