From 5db1ebc1e8e73a61efdb117232c52c98627c4479 Mon Sep 17 00:00:00 2001
From: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Date: Wed, 13 Nov 2024 22:16:46 +0000
Subject: [PATCH] Apply suggestions from code review

---
 doc/usage/extensions/doctest.rst | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/doc/usage/extensions/doctest.rst b/doc/usage/extensions/doctest.rst
index 32b3e6851fa..c5c27a13a92 100644
--- a/doc/usage/extensions/doctest.rst
+++ b/doc/usage/extensions/doctest.rst
@@ -57,7 +57,7 @@ a comma-separated list of group names.
       :type: text
 
       Skip the directive if the python expression *condition* is True.
-      See :ref:`skipif`.
+      See :ref:`skipping tests conditionally <skipif>`.
 
 
 .. rst:directive:: .. testcleanup:: [group]
@@ -73,7 +73,7 @@ a comma-separated list of group names.
       :type: text
 
       Skip the directive if the python expression *condition* is True.
-      See :ref:`skipif`.
+      See :ref:`skipping tests conditionally <skipif>`.
 
 
 .. rst:directive:: .. doctest:: [group]
@@ -87,8 +87,8 @@ a comma-separated list of group names.
 
    .. rst:directive:option:: hide
 
-     Hide the doctest block in other builders.  By default it is shown as a
-     highlighted doctest block.
+     Hide the doctest block in other builders.
+     By default it is shown as a highlighted doctest block.
 
    .. rst:directive:option:: options: doctest flags
       :type: comma separated list
@@ -97,7 +97,9 @@ a comma-separated list of group names.
       tests.  (You still can give explicit flags per example, with doctest comments,
       but they will show up in other builders too.)
 
-      Alternatively, you can give inline doctest options, like in doctest::
+      Alternatively, you can give inline doctest options, like in doctest:
+
+      .. code-block:: pycon
 
          >>> datetime.date.now()   # doctest: +SKIP
          datetime.date(2008, 1, 1)
@@ -149,7 +151,7 @@ a comma-separated list of group names.
       :type: text
 
       Skip the directive if the python expression *condition* is True.
-      See :ref:`skipif`.
+      See :ref:`skipping tests conditionally <skipif>`.
 
 .. rst:directive:: .. testcode:: [group]
 
@@ -159,8 +161,8 @@ a comma-separated list of group names.
 
    .. rst:directive:option:: hide
 
-      Hide the code block in other builders.  By default it is shown as a
-      highlighted code block.
+      Hide the code block in other builders.
+      By default it is shown as a highlighted code block.
 
    .. rst:directive:option:: trim-doctest-flags
                              no-trim-doctest-flags
@@ -173,7 +175,7 @@ a comma-separated list of group names.
       :type: text
 
       Skip the directive if the python expression *condition* is True.
-      See :ref:`skipif`.
+      See :ref:`skipping tests conditionally <skipif>`.
 
    .. note::
 
@@ -202,8 +204,8 @@ a comma-separated list of group names.
 
    .. rst:directive:option:: hide
 
-     Hide the doctest block in other builders.  By default it is shown as a
-     highlighted doctest block.
+     Hide the doctest block in other builders.
+     By default it is shown as a highlighted doctest block.
 
    .. rst:directive:option:: options: doctest flags
       :type: comma separated list
@@ -221,7 +223,7 @@ a comma-separated list of group names.
       :type: text
 
       Skip the directive if the python expression *condition* is True.
-      See :ref:`skipif`.
+      See :ref:`skipping tests conditionally <skipif>`.
 
    Example::