summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniele Procida <daniele@vurt.org>2021-07-13 09:25:37 +0200
committerGitHub <noreply@github.com>2021-07-13 09:25:37 +0200
commit22fbebc7444c8974f101c146f0fc18fe64ab48f6 (patch)
tree23f3a7bd479f2f59bd2fcbc2e850c57a963a6939 /docs
parent4be58fcc369a024bd7ac72bb09af7d230499cccb (diff)
Refs #32880 -- Made some titles consistent in how-to documents.
This retitles documents for consistency, since some already (correctly) begin "How to...".
Diffstat (limited to 'docs')
-rw-r--r--docs/howto/auth-remote-user.txt6
-rw-r--r--docs/howto/custom-file-storage.txt6
-rw-r--r--docs/howto/custom-lookups.txt6
-rw-r--r--docs/howto/custom-management-commands.txt6
-rw-r--r--docs/howto/custom-model-fields.txt6
-rw-r--r--docs/howto/custom-template-backend.txt6
-rw-r--r--docs/howto/custom-template-tags.txt6
-rw-r--r--docs/howto/error-reporting.txt6
-rw-r--r--docs/howto/initial-data.txt6
-rw-r--r--docs/howto/legacy-databases.txt6
-rw-r--r--docs/howto/outputting-csv.txt6
-rw-r--r--docs/howto/outputting-pdf.txt6
-rw-r--r--docs/howto/overriding-templates.txt6
-rw-r--r--docs/howto/upgrade-version.txt6
-rw-r--r--docs/howto/writing-migrations.txt6
15 files changed, 45 insertions, 45 deletions
diff --git a/docs/howto/auth-remote-user.txt b/docs/howto/auth-remote-user.txt
index 9c227ae423..66c35943ba 100644
--- a/docs/howto/auth-remote-user.txt
+++ b/docs/howto/auth-remote-user.txt
@@ -1,6 +1,6 @@
-====================================
-Authentication using ``REMOTE_USER``
-====================================
+=========================================
+How to authenticate using ``REMOTE_USER``
+=========================================
This document describes how to make use of external authentication sources
(where the Web server sets the ``REMOTE_USER`` environment variable) in your
diff --git a/docs/howto/custom-file-storage.txt b/docs/howto/custom-file-storage.txt
index 7fd71ffef0..9974c30452 100644
--- a/docs/howto/custom-file-storage.txt
+++ b/docs/howto/custom-file-storage.txt
@@ -1,6 +1,6 @@
-===============================
-Writing a custom storage system
-===============================
+===================================
+How to write a custom storage class
+===================================
.. currentmodule:: django.core.files.storage
diff --git a/docs/howto/custom-lookups.txt b/docs/howto/custom-lookups.txt
index 52a16ae167..03148b0c44 100644
--- a/docs/howto/custom-lookups.txt
+++ b/docs/howto/custom-lookups.txt
@@ -1,6 +1,6 @@
-==============
-Custom Lookups
-==============
+===========================
+How to write custom lookups
+===========================
.. currentmodule:: django.db.models
diff --git a/docs/howto/custom-management-commands.txt b/docs/howto/custom-management-commands.txt
index e80540afaa..3ecde33d67 100644
--- a/docs/howto/custom-management-commands.txt
+++ b/docs/howto/custom-management-commands.txt
@@ -1,6 +1,6 @@
-========================================
-Writing custom ``django-admin`` commands
-========================================
+==============================================
+How to create custom ``django-admin`` commands
+==============================================
.. module:: django.core.management
diff --git a/docs/howto/custom-model-fields.txt b/docs/howto/custom-model-fields.txt
index 2572b2ed39..dcc276128b 100644
--- a/docs/howto/custom-model-fields.txt
+++ b/docs/howto/custom-model-fields.txt
@@ -1,6 +1,6 @@
-===========================
-Writing custom model fields
-===========================
+=================================
+How to create custom model fields
+=================================
.. currentmodule:: django.db.models
diff --git a/docs/howto/custom-template-backend.txt b/docs/howto/custom-template-backend.txt
index 85d1e7948d..e74524b830 100644
--- a/docs/howto/custom-template-backend.txt
+++ b/docs/howto/custom-template-backend.txt
@@ -1,6 +1,6 @@
-=======================
-Custom template backend
-=======================
+==========================================
+How to implement a custom template backend
+==========================================
Custom backends
---------------
diff --git a/docs/howto/custom-template-tags.txt b/docs/howto/custom-template-tags.txt
index aad254b946..a72dbdd50a 100644
--- a/docs/howto/custom-template-tags.txt
+++ b/docs/howto/custom-template-tags.txt
@@ -1,6 +1,6 @@
-================================
-Custom template tags and filters
-================================
+==============================================
+How to create custom template tags and filters
+==============================================
Django's template language comes with a wide variety of :doc:`built-in
tags and filters </ref/templates/builtins>` designed to address the
diff --git a/docs/howto/error-reporting.txt b/docs/howto/error-reporting.txt
index 7d5b5baf84..d40576817e 100644
--- a/docs/howto/error-reporting.txt
+++ b/docs/howto/error-reporting.txt
@@ -1,6 +1,6 @@
-===============
-Error reporting
-===============
+=============================
+How to manage error reporting
+=============================
When you're running a public site you should always turn off the
:setting:`DEBUG` setting. That will make your server run much faster, and will
diff --git a/docs/howto/initial-data.txt b/docs/howto/initial-data.txt
index b999f037fe..aafe14cc76 100644
--- a/docs/howto/initial-data.txt
+++ b/docs/howto/initial-data.txt
@@ -1,6 +1,6 @@
-=================================
-Providing initial data for models
-=================================
+======================================
+How to provide initial data for models
+======================================
It's sometimes useful to pre-populate your database with hard-coded data when
you're first setting up an app. You can provide initial data with migrations or
diff --git a/docs/howto/legacy-databases.txt b/docs/howto/legacy-databases.txt
index 957b33fc65..052bb9d369 100644
--- a/docs/howto/legacy-databases.txt
+++ b/docs/howto/legacy-databases.txt
@@ -1,6 +1,6 @@
-=========================================
-Integrating Django with a legacy database
-=========================================
+==============================================
+How to integrate Django with a legacy database
+==============================================
While Django is best suited for developing new applications, it's quite
possible to integrate it into legacy databases. Django includes a couple of
diff --git a/docs/howto/outputting-csv.txt b/docs/howto/outputting-csv.txt
index 0026d0293a..44461cf4ce 100644
--- a/docs/howto/outputting-csv.txt
+++ b/docs/howto/outputting-csv.txt
@@ -1,6 +1,6 @@
-==========================
-Outputting CSV with Django
-==========================
+========================
+How to create CSV output
+========================
This document explains how to output CSV (Comma Separated Values) dynamically
using Django views. To do this, you can either use the Python CSV library or the
diff --git a/docs/howto/outputting-pdf.txt b/docs/howto/outputting-pdf.txt
index 8d61418af0..7324039a91 100644
--- a/docs/howto/outputting-pdf.txt
+++ b/docs/howto/outputting-pdf.txt
@@ -1,6 +1,6 @@
-===========================
-Outputting PDFs with Django
-===========================
+=======================
+How to create PDF files
+=======================
This document explains how to output PDF files dynamically using Django views.
This is made possible by the excellent, open-source ReportLab_ Python PDF
diff --git a/docs/howto/overriding-templates.txt b/docs/howto/overriding-templates.txt
index 0f88069069..eed379b3df 100644
--- a/docs/howto/overriding-templates.txt
+++ b/docs/howto/overriding-templates.txt
@@ -1,6 +1,6 @@
-====================
-Overriding templates
-====================
+=========================
+How to override templates
+=========================
In your project, you might want to override a template in another Django
application, whether it be a third-party application or a contrib application
diff --git a/docs/howto/upgrade-version.txt b/docs/howto/upgrade-version.txt
index bde9b18c1b..a2a6a8630e 100644
--- a/docs/howto/upgrade-version.txt
+++ b/docs/howto/upgrade-version.txt
@@ -1,6 +1,6 @@
-===================================
-Upgrading Django to a newer version
-===================================
+========================================
+How to upgrade Django to a newer version
+========================================
While it can be a complex process at times, upgrading to the latest Django
version has several benefits:
diff --git a/docs/howto/writing-migrations.txt b/docs/howto/writing-migrations.txt
index 00dc0dfadf..8ccd650661 100644
--- a/docs/howto/writing-migrations.txt
+++ b/docs/howto/writing-migrations.txt
@@ -1,6 +1,6 @@
-===========================
-Writing database migrations
-===========================
+=================================
+How to create database migrations
+=================================
This document explains how to structure and write database migrations for
different scenarios you might encounter. For introductory material on