--- a/doc/3.20.rst	Thu Oct 02 17:18:29 2014 +0200
+++ b/doc/3.20.rst	Tue Oct 21 11:06:19 2014 +0200
@@ -1,6 +1,21 @@
 What's new in CubicWeb 3.20
 ===========================
 
+New features
+------------
+
+* virtual relations: a new ComputedRelation class can be used in
+  schema.py; its `rule` attribute is an RQL snippet that defines the new
+  relation.
+* computed attributes: an attribute can now be defined with a `formula`
+  argument (also an RQL snippet); it will be read-only, and updated
+  automatically.
+
+  Both of these features are described in `CWEP-002`_, and the updated
+  "Data model" chapter of the CubicWeb book.
+
+.. _CWEP-002: http://hg.logilab.org/review/cwep/file/tip/CWEP-002.rst
+
 Deprecated Code Drops
 ----------------------