diff --git a/README.rst b/README.rst
index c8a99a9d2..2d795ec23 100644
--- a/README.rst
+++ b/README.rst
@@ -74,6 +74,8 @@ in development
 ^^^^^^^^^^^^^^
 
 * Drop support for Python 3.8.
+* Signatures of function definitions are now wrapped onto several lines when the function has the focus. 
+* The first parameter of classmethods and methods (``cls`` or ``self``) is colored in gray so it's clear that these are not part of the API.
 
 pydoctor 24.11.1
 ^^^^^^^^^^^^^^^^