diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b60b1449..4f31bd9cb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.21.8] - 2023-12-19
+
+- Add new rules NestedFunctionNames and UnnestedFunctionNames #564 [@su8898] & [@webwarrior-ws]
+- Addressed regression in the docs CI deploy [@knocte]
+- Move docs CI to main CI (to detect problems earlier next time) #636 [@knocte]
+
+
 ## [0.21.7] - 2023-12-16
 
 - Add new rule SuggestUseAutoProperty #625 #596 [@webwarrior-ws]