docs: Update references to Django docs

Use 5.2 (the most recent LTS) across the board.

Signed-off-by: Stephen Finucane <stephen@that.guru>

Author: stephenfin

docs/deployment/configuration.rst

@@ -27,15 +27,15 @@ Patchwork provides three settings files:
   heavy customization. The :ref:`deployment guide <deployment-settings>`
   provides more information.
 
-__ https://docs.djangoproject.com/en/2.2/topics/settings/
+__ https://docs.djangoproject.com/en/5.2/topics/settings/
 
 Patchwork-specific Settings
 ---------------------------
 
 Patchwork utilizes a number of Patchwork-only settings in addition to the
 `Django`__ and `Django REST Framework`__ settings.
 
-__ https://docs.djangoproject.com/en/2.2/ref/settings/
+__ https://docs.djangoproject.com/en/5.2/ref/settings/
 __ http://www.django-rest-framework.org/api-guide/settings/
 
 ``ADMINS_HIDE``
@@ -46,7 +46,7 @@ If True, the details in `ADMINS`__ will be hidden from the *About* page
 
 .. versionadded:: 2.2
 
-__ https://docs.djangoproject.com/en/2.2/ref/settings/#admins
+__ https://docs.djangoproject.com/en/5.2/ref/settings/#admins
 
 ``COMPAT_REDIR``
 ~~~~~~~~~~~~~~~~

docs/deployment/installation.rst

@@ -134,7 +134,7 @@ __ https://www.postgresql.org/docs/10/static/auth-methods.html#AUTH-PEER
     `latin1` encoding. Refer to the `MySQL documentation`__ for more
     information.
 
-    __ https://docs.djangoproject.com/en/3.1/ref/unicode/
+    __ https://docs.djangoproject.com/en/5.2/ref/unicode/
     __ https://dev.mysql.com/doc/refman/en/charset.html
 
 
@@ -163,7 +163,7 @@ We will install this under ``/opt``, though this is only a suggestion:
    web server's document root as this risks the possibility that people may be
    able to view your code over the Web. This is a security risk.
 
-   __ https://docs.djangoproject.com/en/2.2/intro/tutorial01/#creating-a-project
+   __ https://docs.djangoproject.com/en/5.2/intro/tutorial01/#creating-a-project
 
 Next we require Python. If not already installed, then you should do so now.
 Python 3 is installed by default but you should validate this now:
@@ -218,7 +218,7 @@ variables, you should export each setting using the appropriate name, such as
 ``DJANGO_SECRET_KEY``, ``DATABASE_NAME`` or ``EMAIL_HOST``, instead of
 modifying the ``production.py`` file as we've done below.
 
-__ https://docs.djangoproject.com/en/2.2/ref/settings/
+__ https://docs.djangoproject.com/en/5.2/ref/settings/
 
 Databases
 ^^^^^^^^^
@@ -441,7 +441,7 @@ address(es) from which you will be serving this domain. For example:
 
    ALLOWED_HOSTS = ('.example.com', )
 
-__ https://docs.djangoproject.com/en/2.2/ref/settings/#allowed-hosts
+__ https://docs.djangoproject.com/en/5.2/ref/settings/#allowed-hosts
 
 Create systemd Unit File
 ~~~~~~~~~~~~~~~~~~~~~~~~

docs/deployment/management.rst

@@ -25,7 +25,7 @@ documentation`_. Information on any command can also be found by passing the
 
    ./manage.py cron --help
 
-.. _Django documentation: https://docs.djangoproject.com/en/1.8/ref/django-admin/
+.. _Django documentation: https://docs.djangoproject.com/en/5.2/ref/django-admin/
 
 Available Commands
 ------------------

docs/deployment/upgrading.rst

@@ -69,4 +69,4 @@ which must be applied before starting the instance. To do this, run the
 
 For more information on migrations, refer to `the Django documentation`__.
 
-__ https://docs.djangoproject.com/en/2.2/topics/migrations/
+__ https://docs.djangoproject.com/en/5.2/topics/migrations/

docs/development/installation.rst

@@ -219,7 +219,7 @@ respectively on Debian-based Debian-based distros like Ubuntu and
    supported`__. You will find some tests provided by Patchwork fail and some
    patches you develop may fail in production due to these differences.
 
-__ https://docs.djangoproject.com/en/2.2/ref/databases/
+__ https://docs.djangoproject.com/en/5.2/ref/databases/
 __ https://www.sqlite.org/faq.html#q18
 
 Example Installation

patchwork/settings/base.py

@@ -10,7 +10,7 @@
 
 #
 # Core settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#core-settings
+# https://docs.djangoproject.com/en/5.2/ref/settings/#core-settings
 #
 
 INSTALLED_APPS = [
@@ -83,7 +83,7 @@
 
 #
 # Auth settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#auth
+# https://docs.djangoproject.com/en/5.2/ref/settings/#auth
 #
 
 LOGIN_URL = 'auth_login'
@@ -93,15 +93,15 @@
 
 #
 # Sites settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#sites
+# https://docs.djangoproject.com/en/5.2/ref/settings/#sites
 #
 
 SITE_ID = 1
 
 
 #
 # Static files settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#static-files
+# https://docs.djangoproject.com/en/5.2/ref/settings/#static-files
 #
 
 STATIC_URL = '/static/'
@@ -114,7 +114,7 @@
 #
 # If you're using a postgres database, connecting over a local unix-domain
 # socket, then the following setting should work for you. Otherwise,
-# see https://docs.djangoproject.com/en/2.2/ref/settings/#databases
+# see https://docs.djangoproject.com/en/5.2/ref/settings/#databases
 
 if os.getenv('DATABASE_TYPE') == 'postgres':
     DATABASES = {

patchwork/settings/dev.py

@@ -21,7 +21,7 @@
 
 #
 # Core settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#core-settings
+# https://docs.djangoproject.com/en/5.2/ref/settings/#core-settings
 #
 
 ADMINS = (('Joe Bloggs', 'jbloggs@example.com'),)
@@ -39,11 +39,11 @@
 
 #
 # Auth settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#auth
+# https://docs.djangoproject.com/en/5.2/ref/settings/#auth
 #
 
 # Use a faster, though less secure, password hasher for faster tests
-# https://docs.djangoproject.com/en/2.2/topics/testing/overview/#password-hashing
+# https://docs.djangoproject.com/en/5.2/topics/testing/overview/#password-hashing
 PASSWORD_HASHERS = ['django.contrib.auth.hashers.MD5PasswordHasher']
 
 #

patchwork/settings/production.example.py

@@ -13,7 +13,7 @@
 
 #
 # Core settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#core-settings
+# https://docs.djangoproject.com/en/5.2/ref/settings/#core-settings
 #
 
 # Security
@@ -50,8 +50,8 @@
 
 #
 # Static files settings
-# https://docs.djangoproject.com/en/2.2/ref/settings/#static-files
-# https://docs.djangoproject.com/en/2.2/ref/contrib/staticfiles/#manifeststaticfilesstorage
+# https://docs.djangoproject.com/en/5.2/ref/settings/#static-files
+# https://docs.djangoproject.com/en/5.2/ref/contrib/staticfiles/#manifeststaticfilesstorage
 #
 
 STATIC_ROOT = os.environ.get('STATIC_ROOT', '/srv/patchwork/htdocs/static')