diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 5a5f9f43..2c07e685 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -3,7 +3,7 @@ Change Log
 
 Inspired by `Keepachangelog.com <http://keepachangelog.com/>`__.
 
-- Unreleased - **Breathe v4.31.0**
+- 2021-09-14 - **Breathe v4.31.0**
 
   - Collapse multiple retvals into a single bullet list. `#697 <https://github.com/michaeljones/breathe/pull/697>`__
   - Fix mypy issues on CI. `#731 <https://github.com/michaeljones/breathe/pull/731>`__
diff --git a/README.rst b/README.rst
index 28b1eb2e..3084f85e 100644
--- a/README.rst
+++ b/README.rst
@@ -109,6 +109,9 @@ Release
 
 See the ``mkrelease`` utility in the root of the repository.
 
+Useful vim command for changelog conversion to the git tag format:
+``%s/\v`(#[0-9]+) \<[^`]*`__/\1/g``.
+
 Credits
 -------
 
diff --git a/breathe/__init__.py b/breathe/__init__.py
index 1821c89f..41c569e2 100644
--- a/breathe/__init__.py
+++ b/breathe/__init__.py
@@ -4,7 +4,7 @@
 
 from sphinx.application import Sphinx
 
-__version__ = '4.30.0'
+__version__ = '4.31.0'
 
 
 def setup(app: Sphinx):