+The |version| release of django-registration represents a complete
+rewrite of the previous codebase, and as such introduces a number of
+new features and greatly enhances the flexibility and customizability
+of django-registration. This document summarizes those features; for a
+list of changes which impact existing installations, consult :ref:`the
+upgrade guide <upgrade>`.
+The largest overall change consists of factoring out the logic of user
+registration into pluggable/swappable backend classes. The
+:ref:`registration views <views>` now accept a (required) argument,
+``backend``, which indicates the backend class to use, and that class
+has full control over the registration (and, if needed, activation)
+* Determining whether registration will be allowed at all, on a
+* Specifying a form class to use for account registration.
+* Implementing the actual process of account creation.
+* Determining whether a separate activation step is needed, and if so
+* Specifying actions to take (e.g., redirects, automatic login, etc.)
+ following successful registration or activation.
+For full details, see the documentation for :ref:`the backend API
+The workflow used by previous releases of django-registration
+(two-step registration/activation) has been implemented using this
+system, and is shipped as :ref:`the default backend <default-backend>`
+in django-registration |version|.
+During the registration and (optional) activation process,
+:ref:`custom signals <signals>` are now sent, allowing easy injection
+of custom processing into the registration workflow without needing to
+The default backend now supplies several `custom admin actions
+make the process of administering a site with django-registration
+The :func:`~registration.views.activate` view now supplies any
+captured keyword arguments from the URL (in the case of the default
+backend, this is the activation key) to its template in case of
+unsuccessful activation; this greatly simplifies the process of
+determining why activation failed and displaying appropriate error