doc/rgw: fixup (squash later)

Signed-off-by: Zac Dover <zac.dover@proton.me>

doc/radosgw: refine "Maintenance" in multisite.rst

Refine the text in the "Maintenance" section of
doc/radosgw/multisite.rst.

https://tracker.ceph.com/issues/58632

Co-authored-by: Cole Mitchell <cole.mitchell@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 85816fbca068b740362e2faaf13dc601cdd68c1c)

Merge pull request #49988 from pdvian/wip-58638-pacific

pacific: mon: Fix condition to check for ceph version mismatch

Merge pull request #49454 from guits/wip-58279-pacific

pacific: ceph-volume: fix a bug in get_all_devices_vgs()

Merge pull request #49928 from adk3798/wip-58567-pacific

pacific: mgr/cephadm: call iscsi post_remove from serve loop

Reviewed-by: Redouane Kachach <rkachach@redhat.com>

Merge pull request #49926 from adk3798/wip-58556-pacific

pacific: mgr/cephadm: fix removing offline hosts with ingress daemons

Reviewed-by: Redouane Kachach <rkachach@redhat.com>

Merge pull request #49919 from adk3798/wip-58206-pacific

pacific: mgr/cephadm: don't say migration in progress if migration current > migration last

Reviewed-by: John Mulligan <jmulligan@redhat.com>

Merge pull request #49918 from adk3798/wip-58202-pacific

pacific: mgr/cephadm: specify ports for iscsi

Reviewed-by: John Mulligan <jmulligan@redhat.com>

Merge pull request #49916 from adk3798/wip-58175-pacific

pacific: mgr/cephadm: fix check for if devices have changed

Reviewed-by: Redouane Kachach <rkachach@redhat.com>

Merge pull request #49285 from adk3798/wip-58148-pacific

pacific: mgr/cephadm: some master -> main cleanup

Reviewed-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
Reviewed-by: Redouane Kachach <rkachach@redhat.com>

Merge pull request #50009 from zdover23/wip-doc-2023-02-07-backport-49994-to-pacific

pacific: doc/rgw: refine ~50-~140 of multisite.rst

doc/rgw: refine ~50-~140 of multisite.rst

Remove pleonasm from approximately line 50 to line 140 of
doc/rgw/multisite.rst.

Follows https://github.com/ceph/ceph/pull/49993.

https://tracker.ceph.com/issues/58632

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@gmail.com>
(cherry picked from commit 805a9baeeaaa78aa2bb6f472526cc35361c75456)

Merge pull request #49996 from zdover23/wip-doc-2023-02-06-backport-49993-to-pacific

pacific: doc/rgw: refine 1-50 of multisite.rst

doc/rgw: refine 1-50 of multisite.rst

Refine the English in the first fifty lines of multisite.rst. This is
part of a project whose goal is the creation of a document that will
impart a good aerial view of RGW to a first-time reader in the minimum
number of words.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 6721196ff129b00d9dea3515fbaaacde8f84eaea)

mon: Fix condition to check for ceph version mismatch

MON fails to send MMgrUpdate to the MGR to update
DaemonState with correct metadata information due to
incorrect conditional check. Send MMgrUpdate to MGR
if we observe ceph version mismatch after an election
is over.

Fixes: https://tracker.ceph.com/issues/57678
Signed-off-by: Prashant D <pdhange@redhat.com>
(cherry picked from commit 5dc0d6f7f299cc7af0c243ba67036b075f4b72af)

Merge pull request #49983 from zdover23/wip-doc-2023-02-03-backport-49981-to-pacific

pacific: doc/rgw: refine "Zones" in multisite.rst

doc/rgw: refine "Zones" in multisite.rst

Clean up the English under the section called "Zones". Part of a larger
project aimed at giving the reader more understanding earlier in the
documentation of how buckets and zones and zone groups and endpoints
work.

https://tracker.ceph.com/issues/58632

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

mgr/cephadm: specify ports for iscsi

Fixes: https://tracker.ceph.com/issues/57786
Signed-off-by: Adam King <adking@redhat.com>
(cherry picked from commit 9ee9c940a7d7481a090a2e986753ca7db4fa521e)

Merge pull request #49949 from zdover23/wip-doc-2023-02-01-backport-49946-to-pacific

pacific: doc/cephadm: grammar / syntax in install.rst

doc/cephadm: grammar / syntax in install.rst

Signed-off-by: Piotr Parczewski <piotr@stackhpc.com>
(cherry picked from commit 4cc3cb9cd007c293bf61d20c05b960be2d4cd4fd)

Merge pull request #49933 from zdover23/wip-doc-2023-01-31-backport-49913-to-pacific

pacific: doc: add the damage types that scrub can repair

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc: add the damage types that scrub can repair

Fixes: https://tracker.ceph.com/issues/51459
Signed-off-by: Neeraj Pratap Singh <neesingh@redhat.com>
(cherry picked from commit 87215ab3e4af1ca313376d901f285ed6348b8433)

mgr/cephadm: call iscsi post_remove from server loop

If we call it directly during a synchronous command
from the command line it never returns.

Fixes: https://tracker.ceph.com/issues/58531
Signed-off-by: Adam King <adking@redhat.com>
(cherry picked from commit ea38245ace58789216646262f2078a315f1d2fd5)

mgr/cephadm: fix removing offline hosts with ingress daemons

We need to convert the daemon type to service type here
or we'll try to access the "haproxy" or "keepalived" index
of the cephadm_services dictionary, which doesn't have those
keys (but does have an "ingress" key)

Fixes: https://tracker.ceph.com/issues/58537
Signed-off-by: Adam King <adking@redhat.com>
(cherry picked from commit d9624e066610e7c924b20d8fd8d99a84bf0eea84)

mgr/cephadm: don't say migration in progress if migration current > migration last

We risk ending up in an endless busy loop accomplishing
nothing otherwise.

Fixes: https://tracker.ceph.com/issues/57651
Signed-off-by: Adam King <adking@redhat.com>
(cherry picked from commit 63068800ecd446316ab903cf02da2a243f361b58)

mgr/cephadm: fix check for if devices have changed

Directly comparing the dicts doesn't work since the
"created" field was added in. We should instead make use
of the existing Devices equality function.

Fixes: https://tracker.ceph.com/issues/57999
Signed-off-by: Adam King <adking@redhat.com>
(cherry picked from commit 55661cc859a5160822b5293f7cc49d6fdb5b715d)

Conflicts:
src/pybind/mgr/cephadm/tests/test_cephadm.py

Merge pull request #49911 from zdover23/wip-doc-2023-01-30-special-order-backport-49908-to-pacific

pacific: doc/dev: backport 49908 to P (Upgrade Testing Docs)

doc/dev: backport 49908 to P (Upgrade Testing Docs)

Backport https://github.com/ceph/ceph/pull/49908 to Pacific.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

Merge pull request #49899 from zdover23/wip-doc-2023-01-27-backport-49897-to-pacific

pacific: doc/rados/operations: Fix double prompt

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc/rados/operations: Fix double prompt

In monitoring.rst a double prompt was rendered, one non-selectable and one selectable. Remove the selectable prompt.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit 7d7282c7bdf0396f9a192badeedf66976fa01e5e)

Merge pull request #49893 from zdover23/wip-doc-2023-01-27-backport-49890-to-pacific

pacific: doc/dev: use underscores in config vars

Merge pull request #49896 from zdover23/wip-doc-2023-01-27-backport-49894-to-pacific

pacific: doc/rados/operations: Fix indentation

doc/rados/operations: Fix indentation

Fix invalid indentation that caused indentation to be rendered wrong in control.rst.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit f2e19d39ed303c700c6aab206a1c000c5731baeb)

doc/dev: use underscores in config vars

Use underscores instead of spaces in config vars in ceph_krb_auth.rst.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit ed88f7f378fcb70be57351271aa19b30f81555d4)

Merge pull request #49852 from ceph/pacific-release

v16.2.11

Merge pull request #49875 from zdover23/wip-doc-2023-01-26-backport-49873-to-pacific

pacific: doc/dev: add Slack to Dev Guide essentials

doc/dev: add Slack to Dev Guide essentials

Add Ceph's Slack to doc/developer_guide/essentials.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit c3288cf5be232bded5ccd70925da2452599903ab)

16.2.11

Signed-off-by: Ceph Release Team <ceph-maintainers@ceph.io>

Merge pull request #48933 from s0nea/wip-58042-pacific

pacific: ceph-mixing: fix ceph_hosts variable

Reviewed-by: Avan Thakkar <athakkar@redhat.com>

Merge pull request #49833 from zdover23/wip-doc-2023-01-23-backport-49778-to-pacific

pacific: doc/rados: refine ceph-conf.rst

Merge pull request #49822 from zdover23/wip-doc-2023-01-21-backport-49820-to-pacific

pacific: doc/rados: refine pool-pg-config-ref.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc/rados: refine ceph-conf.rst

Correct grammar and usage in ceph-conf.rst.

https://tracker.ceph.com/issues/58485

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

Merge pull request #49520 from rhcs-dashboard/wip-58319-pacific

pacific: mgr/prometheus: expose daemon health metrics

Reviewed-by: Pegonzal <NOT@FOUND>
Reviewed-by: Aashish Sharma <aasharma@redhat.com>
Reviewed-by: Avan Thakkar <athakkar@redhat.com>

doc/rados: refine pool-pg-config-ref.rst

Remove pleonasm.

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

Merge pull request #49805 from idryomov/wip-doc-exclusive-lock-transitions-pacific

pacific: doc/rbd/rbd-exclusive-locks: warn about automatic lock transitions

Reviewed-by: Ramana Raja <rraja@redhat.com>

doc/rbd/rbd-exclusive-locks: warn about automatic lock transitions

A lot of people aren't aware of automatic lock transitions and
wrongfully assume that exclusive lock means that the image remains
locked for as long as the client is running.  Redo the explanation
and add a warning.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 2af7252b332c17e3ad8a363f13e2404d1276e2bd)

doc/rbd/rbd-exclusive-locks: don't mention "profile rbd" requirement twice

It's (much better) described in the Blocklisting section.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit c966ea99bc5d6fb6e4a3dc41becedb62efa4dd74)

Merge pull request #49793 from zdover23/wip-doc-2023-01-20-backport-49764-to-pacific

pacific: doc/ceph-volume: refine encryption.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/ceph-volume: refine encryption.rst

Improve the word choice and grammar of
doc/ceph-volume/lvm/encryption.rst.

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

Merge pull request #49786 from rhcs-dashboard/wip-58502-pacific

pacific: mgr/prometheus: export zero valued pg state metrics

Reviewed-by: Ernesto Puerta <epuertat@redhat.com>

mgr/prometheus: export zero valued pg state metrics

Fixes: https://tracker.ceph.com/issues/58471
Signed-off-by: Avan Thakkar <athakkar@redhat.com>
As per the Prometheus documentation, omitting zero metrics is not a best practice. The metric value for all PG_STATES should be initialized to zero.

(cherry picked from commit 17d1ecc914b2fe6c5d9e8045a999985988c39447)

Merge pull request #49782 from zdover23/wip-doc-2023-01-19-backport-49780-to-pacific

pacific: doc/install: link to "cephadm installing ceph"

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc/install: link to "cephadm installing ceph"

Link to "Installing Ceph" in the cephadm documentation instead of (as
was the case before this commit) to the cephadm overview page. Anyone
who clicks on the "cephadm" link in the context of the
doc/install/index.rst page is more likely to expect installation
instructions than to expect an explanation of what cephadm is.

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

Merge pull request #49758 from zdover23/wip-doc-2023-01-16-backport-49747-to-pacific

pacific: doc/ceph-volume: update LUKS docs

doc/ceph-volume: update LUKS docs

Remove references that claim that Ceph uses only LUKS version 1.

https://tracker.ceph.com/issues/58354

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

Merge pull request #49752 from zdover23/wip-doc-2023-01-16-backport-49745-to-pacific

pacific: doc/start: add RST escape character rules for bold

Merge pull request #49750 from zdover23/wip-doc-2023-01-16-backport-49716-to-pacific

pacific: doc/rbd: format iscsi-initiator-linux.rbd better

doc/start: add RST escape character rules for bold

Explain how to escape the bold notation (**) within words in RST.

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

doc/rbd: format iscsi-initiator-linux.rbd better

Add prompts and clean up the lists in doc/rbd/iscsi-initiator-linux.rbd.

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

Merge pull request #49739 from zdover23/wip-doc-2023-01-14-backport-49736-to-pacific

pacific: doc/dev: add git branch management commands

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc/dev: add git branch management commands

Add git branch deleting and search commands to the "Basic Workflow" page
of the Developer Guide.

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

Merge pull request #49695 from Matan-B/wip-matanb-pacific-mgr-packaging

pacific: mgr/prometheus: use vendored "packaging" instead

Reviewed-by: Laura Flores <lflores@redhat.com>

Merge pull request #49718 from zdover23/wip-doc-2023-01-11-backport-49715-to-pacific

pacific: doc/cephadm: s/osd/OSD/ where appropriate

doc/cephadm: s/osd/OSD/ where appropriate

Capitalize the initialization "OSD" where it occurs in natural language
in cephadm/host-management.rst. This PR answers a request made by
Anthony D'Atri and seconded by Cole Mitchell in https://github.com/ceph/ceph/pull/49699#discussion_r1066171002.

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

mgr/prometheus: use vendored "packaging" instead

backport of: cf6089200d96fc56b08ee17a4e31f19823370dc8

Signed-off-by: Matan Breizman <mbreizma@redhat.com>

Merge pull request #49696 from idryomov/wip-58398-pacific

pacific: doc/man/ceph-rbdnamer: remove obsolete udev rule

Reviewed-by: Christopher Hoffman <choffman@redhat.com>

Merge pull request #49707 from zdover23/wip-doc-2023-01-11-backport-49699-to-pacific

pacific: doc/cephadm: refine "Removing Hosts"

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>
Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

Merge pull request #49705 from zdover23/wip-doc-2023-01-11-backport-49703-to-pacific

pacific: doc/rados: move colon

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc/cephadm: refine "Removing Hosts"

An intended edit to remove a redundant indefinite article became a
longer (but still brief) full editorial pass.

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

doc/rados: move colon

Move colon in add-or-rm-osds.rst so that the sentence reads properly.

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

Merge pull request #49702 from zdover23/wip-doc-2023-01-11-backport-49700-to-pacific

pacific: doc/css: add top-bar padding for h3 html element

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc/css: add top-bar padding for h3 html element

Add "scroll-margin-top: 4em;" property to h3 html element.

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

Merge pull request #49694 from zdover23/wip-doc-2023-01-11-backport-49692-to-pacific

pacific: doc/css: add "span" padding to custom.css

doc/man/ceph-rbdnamer: remove obsolete udev rule

Fixes: https://tracker.ceph.com/issues/58398
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
(cherry picked from commit 8ca3bd5042094aa0e67d728131f8fa942919717e)

doc/css: add "span" padding to custom.css

Add "scroll-top-bar: 2em;" for the "span" html element in custom.css so
that the top bar doesn't get in the way of headings bounded by the "span
element".

See also https://github.com/ceph/ceph/pull/49644.

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

Merge pull request #49681 from zdover23/wip-doc-2023-01-10-backport-49677-2nd-attempt-to-pacific

pacific: doc/rados: link to cephadm replacing osd section

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

Merge pull request #49684 from zdover23/wip-doc-2023-01-10-backport-49663-to-pacific

pacific: doc: fix a typo

Reviewed-by: Cole Mitchell <cole.mitchell@gmail.com>

doc: fix a typo

Signed-off-by: Brad Fitzpatrick <brad@danga.com>
(cherry picked from commit c670906b49de87514e3b3cce28519c0eba7fad26)

doc/rados: link to cephadm replacing osd section

Direct readers to the "Replacing an OSD" section in the cephadm
documentation, for cases in which the instructions in "Replacing an OSD"
in the RADOS documentation don't work.

https://tracker.ceph.com/issues/58401

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

Merge pull request #49647 from adk3798/pacific-maintenance-syntax

pacific: doc/dev/cephadm: fix host maintenance enter/exit syntax -

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

Merge pull request #49668 from zdover23/wip-doc-2023-01-09-backport-49665-to-pacific

pacific: doc/glossary: Clean up "Ceph Object Storage"

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/glossary: Clean up "Ceph Object Storage"

Remove redundant material under the "Ceph Object Storage" headword and
add a "See 'Ceph Object Store'" link. A future PR will provide a couple
of sentences that explain how object storage is what's really supporting
both CephFS and RBD.

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

Merge pull request #49662 from zdover23/wip-doc-2023-01-07-backport-49658-to-pacific

pacific: doc/css: Add scroll-margin-top to h2 html element

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

Merge pull request #49660 from zdover23/wip-doc-2023-01-07-backport-49653-to-pacific

pacific: doc/man: define --num-rep, --min-rep and --max-rep

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/css: Add scroll-margin-top to h2 html element

Add "scroll-margin-top: 4em;" to the h2 html element's definition in
custom.css. This moves the text under all h2 html elements out of the
way of the sticky-header-style top bar, which previously obscured the
text.

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

doc/man: define --num-rep, --min-rep and --max-rep

Explain the "--num-rep", "--min-rep", and "--max-rep" options, which are
required when running "crushtool" commands with the "--show-mappings"
flag. Originally reported by Brad Fitzpatrick.

https://tracker.ceph.com/issues/58374

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

Merge pull request #49645 from zdover23/wip-doc-2023-01-06-backport-49643-to-pacific

pacific: doc/_static: add scroll-margin-top to custom.css

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/dev/cephadm: fix host maintenance enter/exit syntax -

Signed-off-by: Ranjini Mandyam Narasiodeyar <rmandyam@rmandyam.remote.csb>
(cherry picked from commit ffea636176162c5db0a2f70e1bec9daf56ac8cfc)

doc/_static: add scroll-margin-top to custom.css

Add 4em of padding to the class "section", so that linked-to
destinations are not obscured by the top bar.

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

Merge pull request #49640 from zdover23/wip-doc-2023-01-05-backport-49637-to-pacific

pacific: doc/css: add scroll-margin-top to dt elements

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/css: add scroll-margin-top to dt elements

add "scroll-margin-top: em3;" to custom.css so that the header bar
doesn't obscure the text of headwords in glossary.rst. Note that this
applies only to elements in the documentation that are rendered into
HTML with the dt (which stands for "description term" or "description
list") tag. Other modifications will be necessary in order to ensure
that the anchor points of non-dt elements are not obscured by the header
bar.

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

Merge pull request #49337 from ljflores/wip-tracker-54992

pacific: qa: run e2e test on centos only

Merge pull request #49622 from zdover23/wip-doc-2023-01-04-backport-49620-to-pacific

pacific: doc: fix a couple grammatical things

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc: fix a couple grammatical things

Signed-off-by: Brad Fitzpatrick <brad@danga.com>
(cherry picked from commit b9b6011c11450e292e4d233a444d776cca8fd86e)

Merge pull request #49616 from zdover23/wip-doc-2022-01-03-backport-49613-to-pacific

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

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

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)

Merge pull request #49611 from zdover23/wip-doc-2023-01-02-backport-49609-to-pacific

pacific: doc/start: refine "Quirks of RST"

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/start: refine "Quirks of RST"

Refine the language that was added yesterday, language that explains how
certain aspects of RST work.

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

Merge pull request #49607 from zdover23/wip-doc-2023-01-01-backport-49606-to-pacific

pacific: doc/start: add link-related metadocumentation

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

doc/start: add link-related metadocumentation

Add two kinds of link-related metadocumentation (documentation about how
to write documentation) to the "Documenting Ceph" section of the "Intro
to Ceph" document: 1. metadocumentation about external links, and 2.
metadocumentation about internal links.

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