--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/changes/3.20.rst	Thu Jan 08 22:11:06 2015 +0100
@@ -0,0 +1,78 @@
+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.
+
+* cubicweb-ctl plugins can use the ``cubicweb.utils.admincnx`` function
+  to get a Connection object from an instance name.
+
+* new 'tornado' wsgi backend
+
+* session cookies have the HttpOnly flag, so they're no longer exposed to
+  javascript
+
+* rich text fields can be formatted as markdown
+
+* the edit controller detects concurrent editions, and raises a ValidationError
+  if an entity was modified between form generation and submission
+
+* cubicweb can use a postgresql "schema" (namespace) for its tables
+
+* "cubicweb-ctl configure" can be used to set values of the admin user
+  credentials in the sources configuration file
+
+* in debug mode, setting the _cwtracehtml parameter on a request allows tracing
+  where each bit of output is produced
+
+.. _CWEP-002: http://hg.logilab.org/review/cwep/file/tip/CWEP-002.rst
+
+
+API Changes
+-----------
+
+* ``ucsvreader()`` and ``ucsvreader_pb()`` from the ``dataimport`` module have
+  2 new keyword arguments ``delimiter`` and ``quotechar`` to replace the
+  ``separator`` and ``quote`` arguments respectively. This makes the API match
+  that of Python's ``csv.reader()``.  The old arguments are still supported
+  though deprecated.
+
+* the migration environment's ``remove_cube`` function is now called ``drop_cube``.
+
+* cubicweb.old.css is now cubicweb.css.  The previous "new"
+  cubicweb.css, along with its cubicweb.reset.css companion, have been
+  removed.
+
+* the jquery-treeview plugin was updated to its latest version
+
+
+Deprecated Code Drops
+----------------------
+
+* most of 3.10 and 3.11 backward compat is gone; this includes:
+  - CtxComponent.box_action() and CtxComponent.build_link()
+  - cubicweb.devtools.htmlparser.XMLDemotingValidator
+  - various methods and properties on Entities, replaced by cw_edited and cw_attr_cache
+  - 'commit_event' method on hooks, replaced by 'postcommit_event'
+  - server.hook.set_operation(), replaced by Operation.get_instance(...).add_data()
+  - View.div_id(), View.div_class() and View.create_url()
+  - `*VComponent` classes
+  - in forms, Field.value() and Field.help() must take the form and the field itself as arguments
+  - form.render() must get `w` as a named argument, and renderer.render() must take `w` as first argument
+  - in breadcrumbs, the optional `recurs` argument must be a set, not False
+  - cubicweb.web.views.idownloadable.{download_box,IDownloadableLineView}
+  - primary views no longer have `render_entity_summary` and `summary` methods
+  - WFHistoryVComponent's `cell_call` method is replaced by `render_body`
+  - cubicweb.dataimport.ObjectStore.add(), replaced by create_entity
+  - ManageView.{folders,display_folders}