From d10e569ea5786d3a5babac760c4facb1ff029a68 Mon Sep 17 00:00:00 2001
From: Carlton Gibson <carlton.gibson@noumenal.es>
Date: Tue, 10 May 2022 14:42:13 +0200
Subject: [PATCH] Added stub release notes for 4.2.

---
 docs/faq/install.txt    |   3 +-
 docs/releases/4.2.txt   | 238 ++++++++++++++++++++++++++++++++++++++++
 docs/releases/index.txt |   8 ++
 3 files changed, 247 insertions(+), 2 deletions(-)
 create mode 100644 docs/releases/4.2.txt

diff --git a/docs/faq/install.txt b/docs/faq/install.txt
index d3be972d45..9f4013b138 100644
--- a/docs/faq/install.txt
+++ b/docs/faq/install.txt
@@ -50,10 +50,9 @@ What Python version can I use with Django?
 ============== ===============
 Django version Python versions
 ============== ===============
-2.2            3.5, 3.6, 3.7, 3.8 (added in 2.2.8), 3.9 (added in 2.2.17)
-3.1            3.6, 3.7, 3.8, 3.9 (added in 3.1.3)
 3.2            3.6, 3.7, 3.8, 3.9, 3.10 (added in 3.2.9)
 4.0, 4.1       3.8, 3.9, 3.10
+4.2            3.8, 3.9, 3.10, 3.11
 ============== ===============
 
 For each version of Python, only the latest micro release (A.B.C) is officially
diff --git a/docs/releases/4.2.txt b/docs/releases/4.2.txt
new file mode 100644
index 0000000000..5a23e285fa
--- /dev/null
+++ b/docs/releases/4.2.txt
@@ -0,0 +1,238 @@
+============================================
+Django 4.2 release notes - UNDER DEVELOPMENT
+============================================
+
+*Expected April 2023*
+
+Welcome to Django 4.2!
+
+These release notes cover the :ref:`new features <whats-new-4.2>`, as well as
+some :ref:`backwards incompatible changes <backwards-incompatible-4.2>` you'll
+want to be aware of when upgrading from Django 4.1 or earlier. We've
+:ref:`begun the deprecation process for some features
+<deprecated-features-4.2>`.
+
+See the :doc:`/howto/upgrade-version` guide if you're updating an existing
+project.
+
+Python compatibility
+====================
+
+Django 4.2 supports Python 3.8, 3.9, 3.10, and 3.11. We **highly recommend**
+and only officially support the latest release of each series.
+
+.. _whats-new-4.2:
+
+What's new in Django 4.2
+========================
+
+Minor features
+--------------
+
+:mod:`django.contrib.admin`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.admindocs`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.auth`
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.contenttypes`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.gis`
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.messages`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.postgres`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.redirects`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.sessions`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.sitemaps`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.sites`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.staticfiles`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+:mod:`django.contrib.syndication`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+Cache
+~~~~~
+
+* ...
+
+CSRF
+~~~~
+
+* ...
+
+Decorators
+~~~~~~~~~~
+
+* ...
+
+Email
+~~~~~
+
+* ...
+
+Error Reporting
+~~~~~~~~~~~~~~~
+
+* ...
+
+File Storage
+~~~~~~~~~~~~
+
+* ...
+
+File Uploads
+~~~~~~~~~~~~
+
+* ...
+
+Forms
+~~~~~
+
+* ...
+
+Generic Views
+~~~~~~~~~~~~~
+
+* ...
+
+Internationalization
+~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+Logging
+~~~~~~~
+
+* ...
+
+Management Commands
+~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+Migrations
+~~~~~~~~~~
+
+* ...
+
+Models
+~~~~~~
+
+* ...
+
+Requests and Responses
+~~~~~~~~~~~~~~~~~~~~~~
+
+* ...
+
+Security
+~~~~~~~~
+
+* ...
+
+Serialization
+~~~~~~~~~~~~~
+
+* ...
+
+Signals
+~~~~~~~
+
+* ...
+
+Templates
+~~~~~~~~~
+
+* ...
+
+Tests
+~~~~~
+
+* ...
+
+URLs
+~~~~
+
+* ...
+
+Utilities
+~~~~~~~~~
+
+* ...
+
+Validators
+~~~~~~~~~~
+
+* ...
+
+.. _backwards-incompatible-4.2:
+
+Backwards incompatible changes in 4.2
+=====================================
+
+Database backend API
+--------------------
+
+This section describes changes that may be needed in third-party database
+backends.
+
+* ...
+
+Miscellaneous
+-------------
+
+* ...
+
+.. _deprecated-features-4.2:
+
+Features deprecated in 4.2
+==========================
+
+Miscellaneous
+-------------
+
+* ...
diff --git a/docs/releases/index.txt b/docs/releases/index.txt
index fa407a2721..b1224ac096 100644
--- a/docs/releases/index.txt
+++ b/docs/releases/index.txt
@@ -20,6 +20,14 @@ versions of the documentation contain the release notes for any later releases.
 
 .. _development_release_notes:
 
+4.2 release
+-----------
+
+.. toctree::
+   :maxdepth: 1
+
+   4.2
+
 4.1 release
 -----------
 .. toctree::