--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/changes/3.21.rst	Thu Jul 02 19:54:25 2015 +0200
@@ -0,0 +1,74 @@
+What's new in CubicWeb 3.21?
+============================
+
+New features
+------------
+
+* the datadir-url configuration option lets one choose where static data files
+  are served (instead of the default ${base-url}/data/)
+
+* some integrity checking that was previously implemented in Python was
+  moved to the SQL backend.  This includes some constraints, and
+  referential integrity.  Some consequences are that:
+
+  - disabling integrity hooks no longer disables those checks
+  - upgrades that modify constraints will fail when running on sqlite
+    (but upgrades aren't supported on sqlite anyway)
+
+* for easier instance monitoring, cubicweb can regularly dump some statistics
+  (basically those exposed by the 'info' and 'gc' views) in json format to a file
+
+User-visible changes
+--------------------
+
+* the use of fckeditor for text form fields is disabled by default
+
+* the 'https-deny-anonymous' configuration setting no longer exists
+
+Code movement
+-------------
+
+The cubicweb.web.views.timeline module (providing the timeline-json, timeline
+and static-timeline views) has moved to a standalone cube_
+
+.. _cube: https://www.cubicweb.org/project/cubicweb-timeline
+
+API changes
+-----------
+
+* req.set_cookie's "expires" argument, if not None, is expected to be a
+  date or a datetime in UTC.  It was previously interpreted as localtime
+  with the UTC offset the server started in, which was inconsistent (we
+  are not aware of any users of that API).
+
+* the way to run tests on a postgresql backend has changed slightly, use
+  cubicweb.devtools.{start,stop}pgcluster in setUpModule and tearDownModule
+
+* the Connection and ClientConnection objects introduced in CubicWeb 3.19 have
+  been unified.  To connect to a repository, use::
+
+    session = repo.new_session(login, password=...)
+    with session.new_cnx() as cnx:
+        cnx.execute(...)
+  
+  In tests, the 'repo_cnx' and 'client_cnx' methods of RepoAccess are now
+  aliases to 'cnx'.
+
+Deprecated code drops
+---------------------
+
+* the user_callback api has been removed; people should use plain
+  ajax functions instead
+
+* the `Pyro` and `Zmq-pickle` remote repository access methods have
+  been entirely removed (emerging alternatives such as rqlcontroller
+  and cwclientlib should be used instead).  Note that as a side effect,
+  "repository-only" instances (i.e. without a http component) are no
+  longer possible.  If you have any such instances, you will need to
+  rename the configuration file from repository.conf to all-in-one.conf
+  and run ``cubicweb-ctl upgrade`` to update it.  Likewise, remote cubicweb-ctl
+  shell is no longer available.
+
+* the old (deprecated since 3.19) `DBAPI` api is completely removed
+
+* cubicweb.toolsutils.config_connect() has been removed