diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 4fd744b..330f520 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -1,6 +1,13 @@
 Changelog
 =========
 
+Version 0.31.1 (TODO: DATE)
+---------------------------
+
+Enhancements:
+
+- cleaned up the README, rearranged other documentation.
+
 Version 0.31.0 (2023-12-30)
 ---------------------------
 
diff --git a/pyproject.toml b/pyproject.toml
index 159e27b..00db708 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,8 +4,8 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "argh"
-version = "0.31.0"
-description = "An unobtrusive argparse wrapper with natural syntax"
+version = "0.31.1"
+description = "Plain Python functions as CLI commands without boilerplate"
 readme = "README.rst"
 requires-python = ">=3.8"
 license = { file = "COPYING.LESSER" }