diff --git a/docs/manual/src/docbook/new-3-1.xml b/docs/manual/src/docbook/new-3-1.xml
new file mode 100644
index 0000000000..36c0bfd9c0
--- /dev/null
+++ b/docs/manual/src/docbook/new-3-1.xml
@@ -0,0 +1,67 @@
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="new-3.1"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <info>
+        <title>What's new in Spring Security 3.1</title>
+    </info>
+    <para>This section contains summary of the updates found in Spring Security 3.1. A detailed list of changes can be found in the project's
+    <link xlink:href="https://jira.springsource.org/secure/IssueNavigator!executeAdvanced.jspa?jqlQuery=project+%3D+SEC+AND+fixVersion+in+%2812315%2C+11892%2C+11634%2C+11633%2C+11632%2C+11174%29+order+by+priority%2C+type&amp;runQuery=true&amp;clear=true">JIRA</link></para>
+    <section xml:id="new-3.1-highlevel">
+        <title>High level updates found Spring Security 3.1</title>
+        <para>Below you can find a high level summary of updates to Spring Security 3.1.</para>
+        <itemizedlist>
+            <listitem>Support for multiple http elements</listitem>
+            <listitem>Support for stateless authentication</listitem>
+            <listitem>DebugFilter provides additional debugging information</listitem>
+            <listitem>Improved Active Directory LDAP support (i.e. ActiveDirectoryLdapAuthenticationProvider)</listitem>
+            <listitem>Added Basic Crypto Module.</listitem>
+            <listitem>The namespace is fully documented in the reference appendix.</listitem>
+            <listitem>Added dependencies section to the reference appendix</listitem>
+            <listitem>Support HttpOnly Flag for Cookies in Servlet 3.0 environments</listitem>
+            <listitem>InMemoryUserDetailsManager provides in memory implementation of UserDetailsManager</listitem>
+            <listitem>Support for hasPermission expression on the authorize JSP tag</listitem>
+            <listitem>Support for disabling UI security (for testing purposes)</listitem>
+            <listitem>Support erasing credentials after successful authentication</listitem>
+            <listitem>Support clearing cookies on logout</listitem>
+            <listitem>Spring Security Google App Engine example application</listitem>
+            <listitem>Support for CAS proxy tickets</listitem>
+            <listitem>Support for arbitrary implementations of JAAS Configuration</listitem>
+            <listitem>Support nested switching of users for SwitchUserFilter</listitem>
+        </itemizedlist>
+    </section>
+    <section xml:id="new-3.1-ns">
+        <title>Spring Security 3.1 namespace updates</title>
+        <para>Below you can find a summary of updates to the Spring Security 3.1 namespace.</para>
+        <itemizedlist>
+            <listitem>Added support for multiple <link xlink:href="#nsa-http">&lt;http&gt;</link> elements and support for determining which one to use with
+                <link xlink:href="#nsa-http-pattern">http@pattern</link>, <link xlink:href="#nsa-http-request-matcher">http@request-matcher</link>, and
+                <link xlink:href="#nsa-http-security">http@security</link>.
+                Further information can be found in <link xlink:href="#ns-config">Namespace Configuration</link> section of the reference.</listitem>
+            <listitem>Added stateless option for <link xlink:href="#nsa-http-create-session">http@create-session</link></listitem>
+            <listitem>Added support for <link xlink:href="#nsa-http-authentication-manager-ref">http@authentication-manager-ref</link>
+                and <link xlink:href="#nsa-global-method-security-authentication-manager-ref">global-method-security@authentication-manager-ref</link>.</listitem>
+            <listitem>Added <link xlink:href="#nsa-http-name">http@name</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-http-request-matcher-ref">http@request-matcher-ref</link> and
+                <link xlink:href="#nsa-filter-chain-request-matcher-ref">filter-chain@request-matcher-ref</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-debug">&lt;debug&gt;</link></listitem>
+            <listitem>Added Support for setting the AuthenticationDetailsSource using the namespace. See
+                <link xlink:href="#nsa-form-login-authentication-details-source-ref">form-login@authentication-details-source-ref</link>,
+                <link xlink:href="#nsa-openid-login-authentication-details-source-ref">openid-login@authentication-details-source-ref</link>,
+                <link xlink:href="#nsa-http-basic-authentication-details-source-ref">http-basic@authentication-details-source-ref</link>, and
+                <link xlink:href="#nsa-x509-authentication-details-source-ref">x509@authentication-details-source-ref</link>.</listitem>
+            <listitem>Added support for http/expression-handler. This allows
+                <link xlink:href="#nsa-expression-handler">&lt;expression-handler&gt;</link> to be used for web access expressions.</listitem>
+            <listitem>Added <link xlink:href="#nsa-authentication-manager-erase-credentials">authentication-manager@erase-credentials</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-http-basic-entry-point-ref">http-basic@entry-point-ref</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-logout-delete-cookies">logout@delete-cookies</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-remember-me-authentication-success-handler-ref">remember-me@authentication-success-handler-ref</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-method-security-metadata-source">&lt;metadata-source-ref&gt;</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-global-method-security-metadata-source-ref">global-method-security@metadata-source-ref</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-global-method-security-mode">global-method-security@mode</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-attribute-exchange">&lt;attribute-exchange&gt;</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-remember-me-use-secure-cookie">remember-me@use-secure-cookie</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-http-jaas-api-provision">http@jaas-api-provision</link></listitem>
+            <listitem>Added <link xlink:href="#nsa-form-login-username-parameter">form-login@username-parameter</link> and
+                <link xlink:href="#nsa-form-login-password-parameter">form-login@password-parameter</link></listitem>
+        </itemizedlist>
+    </section>
+</chapter>
diff --git a/docs/manual/src/docbook/springsecurity.xml b/docs/manual/src/docbook/springsecurity.xml
index 03346f3a5b..07b8b916ba 100644
--- a/docs/manual/src/docbook/springsecurity.xml
+++ b/docs/manual/src/docbook/springsecurity.xml
@@ -93,6 +93,7 @@
                 plus links to articles, videos and tutorials. </para>
         </partintro>
         <xi:include href="introduction.xml"/>
+        <xi:include href="new-3-1.xml"/>
         <xi:include href="namespace-config.xml"/>
         <xi:include href="samples.xml"/>
         <xi:include href="community.xml"/>