From 22fbebc7444c8974f101c146f0fc18fe64ab48f6 Mon Sep 17 00:00:00 2001 From: Daniele Procida Date: Tue, 13 Jul 2021 09:25:37 +0200 Subject: [PATCH] Refs #32880 -- Made some titles consistent in how-to documents. This retitles documents for consistency, since some already (correctly) begin "How to...". --- docs/howto/auth-remote-user.txt | 6 +++--- docs/howto/custom-file-storage.txt | 6 +++--- docs/howto/custom-lookups.txt | 6 +++--- docs/howto/custom-management-commands.txt | 6 +++--- docs/howto/custom-model-fields.txt | 6 +++--- docs/howto/custom-template-backend.txt | 6 +++--- docs/howto/custom-template-tags.txt | 6 +++--- docs/howto/error-reporting.txt | 6 +++--- docs/howto/initial-data.txt | 6 +++--- docs/howto/legacy-databases.txt | 6 +++--- docs/howto/outputting-csv.txt | 6 +++--- docs/howto/outputting-pdf.txt | 6 +++--- docs/howto/overriding-templates.txt | 6 +++--- docs/howto/upgrade-version.txt | 6 +++--- docs/howto/writing-migrations.txt | 6 +++--- 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 ` 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