Expanded notes on alphas in release How-to.

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/internals/howto-release-django.txt b/docs/internals/howto-release-django.txt
index 9803558805..00264ab2fa 100644
--- a/docs/internals/howto-release-django.txt
+++ b/docs/internals/howto-release-django.txt
@@ -134,6 +134,12 @@ any time leading up to the actual release:
 
    and then commit the changed man page.
 
+#. If this is the alpha release of a new series, create a new stable branch
+   from master. For example, when releasing Django 3.1::
+
+    $ git checkout -b stable/3.1.x origin/master
+    $ git push origin -u stable/3.1.x:stable/3.1.x
+
 #. If this is the "dot zero" release of a new series, create a new branch from
    the current stable branch in the `django-docs-translations
    <https://github.com/django/django-docs-translations>`_ repository. For
@@ -291,6 +297,9 @@ Now you're ready to actually put the release out there. To do this:
 
         $ scp Django-* djangoproject.com:/home/www/www/media/releases/A.B
 
+   If this is the alpha release of a new series, you will need to create the
+   directory A.B.
+
 #. Upload the checksum file(s)::
 
         $ scp Django-A.B.C.checksum.txt.asc djangoproject.com:/home/www/www/media/pgp/Django-A.B.C.checksum.txt
@@ -335,6 +344,11 @@ Now you're ready to actually put the release out there. To do this:
 
    __ https://www.djangoproject.com/admin/releases/release/add/
 
+   If this is the alpha release of a new series, also create a Release object
+   for the *final* release, ensuring that the *Release date* field is blank,
+   thus marking it as *unreleased*. For example, when creating the Release
+   object for ``3.1a1``, also create ``3.1`` with the Release date field blank.
+
 #. Make the blog post announcing the release live.
 
 #. For a new version release (e.g. 1.5, 1.6), update the default stable version