From: Zac Dover <zac.dover@gmail.com>
Date: Mon, 2 Jan 2023 13:00:55 +0000 (+1000)
Subject: doc/start: add Anthony D'Atri's suggestions
X-Git-Tag: v17.2.6~242^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=4784b1b39bf06e14fb5a17a58b890bfbb21a0edd;p=ceph.git

doc/start: add Anthony D'Atri's suggestions

Add the suggestions made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/49609.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
(cherry picked from commit 6141c5f0618432b5dc23d53b5920cab48aa5db7e)
---

diff --git a/doc/start/documenting-ceph.rst b/doc/start/documenting-ceph.rst
index b9530374b7b9..204fd9bf689c 100644
--- a/doc/start/documenting-ceph.rst
+++ b/doc/start/documenting-ceph.rst
@@ -729,10 +729,10 @@ This is the formula for links to addresses external to the Ceph documentation:
    
    Do not fail to include the underscore after the final backtick.
 
-   To link to addresses that are external to the Ceph documentation, you have
-   to include a space between the inline text and the angle bracket that
-   precedes the external address. This is precisely the opposite of :ref:`the
-   convention for inline text that links to a location inside the Ceph
+   To link to addresses that are external to the Ceph documentation, include a
+   space between the inline text and the angle bracket that precedes the
+   external address. This is precisely the opposite of :ref:`the convention for
+   inline text that links to a location inside the Ceph
    documentation<internal_link_with_inline_text>`. If this seems inconsistent
    and confusing to you, then you're right. It is inconsistent and confusing.
 
@@ -741,10 +741,10 @@ See also ":ref:`External Hyperlink Example<start_external_hyperlink_example>`".
 Internal Links
 ~~~~~~~~~~~~~~
 
-To link to a section that is in the Ceph documentation, you must (1) define a
-target link before the section and then (2) link to that target from another
-location in the documentation. Here are the formulas for targets and links to
-those targets:
+To link to a section in the Ceph documentation, you must (1) define a target
+link before the section and then (2) link to that target from another location
+in the documentation. Here are the formulas for targets and links to those
+targets:
 
 Target::