Start 5.next book

Author: markstory

config/conf.py

@@ -10,13 +10,13 @@
 # built documents.
 #
 # The short X.Y version.
-version = '5.x'
+version = '5.next'
 
 # The full version, including alpha/beta/rc tags.
-release = '5.x'
+release = '5.next'
 
 # The search index version.
-search_version = '5'
+search_version = '5-next'
 
 # The marketing diplay name for the book.
 version_name = 'Chiffon'
@@ -31,15 +31,15 @@
     {'name': '1.2', 'number': '1.2', 'title': '1.2 Book'},
     {'name': '1.1', 'number': '1.1', 'title': '1.1 Book'},
 ]
-# 5.x is pre-release still.
-is_prerelease = False
+# 5.next is pre-release still.
+is_prerelease = True
 
 # Languages available.
 languages = ['en', 'pt_BR', 'es', 'ja', 'fr']
 
 # The GitHub branch name for this version of the docs
 # for edit links to point at.
-branch = '5.x'
+branch = '5.next'
 
 # Add any paths that contain custom themes here, relative to this directory.
 html_theme_path = []

en/appendices.rst

@@ -12,6 +12,7 @@ introduced in each version and the migration path between versions.
 
     appendices/5-0-upgrade-guide
     appendices/5-0-migration-guide
+    appendices/5-1-upgrade-guide
 
 Backwards Compatibility Shimming
 ================================

en/appendices/5-1-upgrade-guide.rst

@@ -0,0 +1,16 @@
+5.1 Upgrade Guide
+#################
+
+The 5.1.0 release is a backwards compatible with 5.0. It adds new functionality
+and introduces new deprecations. Any functionality deprecated in 5.x will be
+removed in 6.0.0.
+
+
+New Features
+============
+
+Http
+----
+
+- ``SecurityHeadersMiddleware::setPermissionsPolicy()`` was added. This method
+  adds the ability to define ``permissions-policy`` header values.

en/security/security-headers.rst

@@ -11,6 +11,7 @@ headers to responses:
 * ``X-Download-Options``
 * ``X-Frame-Options``
 * ``Referrer-Policy``
+* ``Permissions-Policy``
 
 This middleware is configured using a fluent interface before it is applied to
 your application's middleware stack::