Refs #32880 -- Improved some headings and text in logging topic.

1 files changed, 10 insertions, 10 deletions

diff --git a/docs/topics/logging.txt b/docs/topics/logging.txt
index da051d8559..e8c4b48e6a 100644
--- a/docs/topics/logging.txt
+++ b/docs/topics/logging.txt
@@ -5,8 +5,8 @@ Logging
 .. module:: django.utils.log
    :synopsis: Logging tools for Django applications
 
-A quick logging primer
-======================
+Overview
+========
 
 Django uses Python's builtin :mod:`logging` module to perform system logging.
 The usage of this module is discussed in detail in Python's own documentation.
@@ -68,7 +68,7 @@ it is passed to a *Handler*.
 Handlers
 ~~~~~~~~
 
-The handler is the engine that determines what happens to each message
+The *handler* is the engine that determines what happens to each message
 in a logger. It describes a particular logging behavior, such as
 writing a message to the screen, to a file, or to a network socket.
 
@@ -89,7 +89,7 @@ file for later analysis.
 Filters
 ~~~~~~~
 
-A filter is used to provide additional control over which log records
+A *filter* is used to provide additional control over which log records
 are passed from logger to handler.
 
 By default, any log message that meets log level requirements will be
@@ -111,14 +111,14 @@ can be used in a chain to perform multiple filtering actions.
 Formatters
 ~~~~~~~~~~
 
-Ultimately, a log record needs to be rendered as text. Formatters
+Ultimately, a log record needs to be rendered as text. *Formatters*
 describe the exact format of that text. A formatter usually consists
 of a Python formatting string containing
 :ref:`LogRecord attributes <python:logrecord-attributes>`; however,
 you can also write custom formatters to implement specific formatting behavior.
 
-Using logging
-=============
+How to use logging
+==================
 
 Once you have configured your loggers, handlers, filters and
 formatters, you need to place logging calls into your code. Using the
@@ -492,11 +492,11 @@ configuring the logging in your settings file will load your logging config
 immediately. As such, your logging config must appear *after* any settings on
 which it depends.
 
-Django's logging extensions
-===========================
+Django logging extension reference
+==================================
 
 Django provides a number of utilities to handle the unique
-requirements of logging in Web server environment.
+requirements of logging in a web server environment.
 
 Loggers
 -------