doc/mgr: edit telemetry (3 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits the third hundred lines in doc/mgr/telemetry.rst.

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

Merge pull request #63849 from zdover23/wip-doc-2025-06-10-backport-63836-to-squid

squid: doc/rados/operations: Address suggestions for stretch-mode.rst

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

Merge pull request #63777 from zdover23/wip-doc-2025-06-06-backport-63741-to-squid

squid: doc/mgr: edit telemetry (4 of x)

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

Merge pull request #63771 from zdover23/wip-doc-2025-06-06-backport-63739-to-squid

squid: doc/mgr: edit telemetry (2 of x)

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

Merge pull request #63861 from zdover23/wip-doc-2025-06-11-backport-63842-to-squid

squid: doc/rados: enhance "pools.rst"

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

Merge pull request #63830 from zdover23/wip-doc-2025-06-10-backport-63745-to-squid

squid: doc/rados/ops: edit cache-tiering.rst

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

doc/mgr: edit telemetry (4 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits the final part of doc/mgr/telemetry.rst.

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

Merge pull request #63864 from zdover23/wip-doc-2025-06-11-backport-63826-to-squid

squid: doc/mgr: edit telemetry.rst

Merge pull request #63867 from zdover23/wip-doc-2025-06-11-backport-63827-to-squid

squid: doc/mgr: edit telemetry.rst (lines 300-400)

Merge pull request #63828 from zdover23/wip-doc-2025-06-10-rados-ops-user-management-58235-followup-squid-only

doc/rados: edit ops/user-management.rst

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

doc/mgr: edit telemetry.rst (lines 300-400)

Edit doc/mgr/telemetry.rst (lines 300-400).

Follow up on the suggestions made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63741 (except for the one about
including Lovecraftian lore in the dummy user data in this file).

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

doc/mgr: edit telemetry.rst

Edit doc/mgr/telemetry.rst.

Follow up on the suggestions made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63740.

Make several changes that were not earmarked in that PR, but that
nonetheless improve the quality of the English in telemetry.rst.

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

doc/rados: enhance "pools.rst"

Add a link to the instructions for modifying a user's caps for a given
pool. Add this link where it makes sense to add it. Add this link where
the reader would naturally want to have the link.

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

Merge pull request #63846 from zdover23/wip-doc-2025-06-10-backport-63841-to-squid

squid: doc/rbd: add mirroring troubleshooting info

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

doc/rados/operations: Address suggestions for stretch-mode.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
fixup

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

doc/rbd: add mirroring troubleshooting info

Add a note to doc/rbd/rbd-mirroring.rst that directs the reader to set
both "site-a" and "site-b" to have the same pool names in the event that
rbd throws the error message "failed to import peer bootstrap token".

This information was reported to the Ceph upstream by Petr Tlapa in June
of 2025, and credit for its development goes to Petr.

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

doc/rados/ops: edit cache-tiering.rst

Remove part of a sentence that might have led readers to think that it
is a good idea to deploy cache tiering on releases prior to Reef.

This incorporates Anthony D'Atri's suggestion from here: https://github.com/ceph/ceph/pull/63614#discussion_r2116020937

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

Merge pull request #62909 from zdover23/wip-doc-2025-04-22-backport-62877-to-squid

squid: doc/radosgw: Improve and more consistent formatting

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

Merge pull request #62502 from zdover23/wip-doc-2025-03-26-backport-62459-to-squid

squid: src/common: add guidance for deep-scrubbing ratio warning

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

doc/rados: edit ops/user-management.rst

Edit an sentence in the imperative mood so that it matches the general
form of imperative sentences immediately preceding commands that contain
replaceable portions.

This commit targets only the Squid release branch.

Follows up on https://github.com/ceph/ceph/pull/58235/.

Tracker: https://tracker.ceph.com/issues/66617

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

Merge pull request #62852 from cbodley/wip-70957-squid

squid: common: CephContext::_refresh_perf_values() checks for null _mempool_perf

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

Merge pull request #62534 from yuvalif/wip-70687-squid

squid: RGW|Bucket Notification: fix for v2 topics rgw-admin list operation

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62400 from sajibreadd/wip-67700-squid

squid: OSD: Split osd_recovery_sleep into settings applied to degraded or clean PGs

Reviewed-by: Igor Fedotov <ifedotov@suse.com>

Merge pull request #63815 from zdover23/wip-doc-2025-06-09-backport-62714-to-squid

squid: doc/rados/operations: Improve stretch-mode.rst

doc/rados/operations: Improve stretch-mode.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit 8c27efcf0e41e5ed14a578a271b457ed3758cbda)

Merge PR #58235 into squid

* refs/pull/58235/head:
doc: add documentation for `ceph auth rotate`
PendingReleaseNotes: add note for new `auth rotate`
qa: test `auth rotate`
mon/AuthMonitor: add `ceph auth rotate` command

Reviewed-by: Nitzan Mordechai <nmordech@redhat.com>

doc/mgr: edit telemetry (2 of x)

Improve the English and the formatting in doc/mgr/telemetry.rst. This
follows up on https://github.com/ceph/ceph/pull/63476.

This commit edits the second hundred lines in doc/mgr/telemetry.rst.

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

Merge pull request #63704 from zdover23/wip-doc-2025-06-04-backport-63622-to-squid

squid: doc/mgr/dashboard_plugins: edit feature_toggles.inc.rst

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

doc/radosgw: Improve and more consistent formatting

Use inline code formatting consistently for command
line switches, data, hostnames, etc.
Correctly indent text and child lists in list items.
Remove a mid-sentence double spaces.
Capitalize "RGW" and "API" in text.
Remove unordered lists that are just regular text
everywhere else.
Use correct prompt # instead of $ for privileged
commands.
Use line continuation for multi-line example commands
instead of render them incorrectly as separate
single-line commands.
Use Title Case in few section header text that
missed it.
multisite.rst: Don't repeat "(RGW)" after "RADOS
Gateway" beyond the first instance in the same
paragraph.
multisite.rst: Change one "multisite" to "multi-site"
because all other instances use this spelling (EXCEPT
the title of the document??).
multisite.rst: Fix indentation of continuation lines in
prompted example commands.
Use pre-formatted block, as seen elsewhere in docs,
instead of strange unordered list plus inline code for
syntax example.
Add space before backslash for multi-line command
continuation.

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

Merge pull request #63683 from zdover23/wip-doc-2025-06-04-backport-63628-to-squid

squid: doc/rados: edit balancer.rst

Merge pull request #63743 from zdover23/wip-doc-2025-06-05-backport-63734-to-squid

squid: doc/mgr: edit cli_api

doc/mgr: edit cli_api

Improve the English in doc/mgr/cli_api.rst. Incorporate the changes
suggested by Anthony D'Atri in https://github.com/ceph/ceph/pull/63195.

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

Merge pull request #61641 from zdover23/wip-doc-2025-02-04-backport-61620-to-squid

squid: doc: src: modernize sample.ceph.conf

Merge pull request #63737 from zdover23/wip-doc-2025-06-05-backport-63733-to-squid

squid: doc/glossary: s/OMAP/omap/

doc/glossary: s/OMAP/omap/

Change "OMAP" to "omap" to match the capitalization established by
Eleanor Cawthon in her 2012 omap paper, here:
https://ceph.io/assets/pdfs/CawthonKeyValueStore.pdf.

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

Merge pull request #63707 from zdover23/wip-doc-2025-06-04-backport-63686-to-squid

squid: doc/start: edit documenting-ceph.rst

Merge pull request #63458 from vshankar/wip-client-secfix-squid

squid: client: disallow unprivileged users to escalate root privileges

Reviewed-by: Milind Changire <mchangir@redhat.com>

Merge pull request #63423 from zdover23/wip-doc-2025-05-22-backport-63369-to-squid

squid: doc/mgr: edit diskpredictor.rst

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

doc/start: edit documenting-ceph.rst

Edit the section "Build the Source (First Time)" in
doc/start/documenting-ceph.rst.

- remove references to RHEL7 (it's old)
- improve sentences (they were first-draft-like)
- improve RST formatting

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

Merge pull request #63689 from zdover23/wip-doc-2025-06-04-backport-63195-to-squid

squid: doc/mgr: edit cli_api.rst

Merge pull request #63692 from zdover23/wip-doc-2025-06-04-backport-63476-to-squid

squid: doc/mgr: edit telemetry.rst

Merge pull request #63680 from zdover23/wip-doc-2025-06-04-backport-63623-to-squid

squid: doc/mgr: edit iostat.rst

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

doc/mgr/dashboard_plugins: edit feature_toggles.inc.rst

Follow up on the suggestions made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63367.

- Add "nvmeof" to the list of enabled features.
- Remove an extraneous space.

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

Merge pull request #63646 from zdover23/wip-doc-2025-06-03-backport-63618-to-squid

squid: doc/rados/operations: Improve placement-groups.rst

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

doc: src: modernize sample.ceph.conf

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit 01502bb23e796eaa92e2a1671cb611b21978c158)

doc/mgr: edit telemetry.rst

Edit doc/mgr/telemetry.rst.

The English in this file is unacceptably demotic and exhibits a curious
but all-too-familiar lack here and there of definite articles.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

doc/mgr: edit cli_api.rst

Edit doc/mgr/cli_api.rst as part of the project to determine where the
error is in https://github.com/ceph/ceph/pull/62782 that prevents the
Jenkins tests from passing.

This is a change to one of twenty-five files in
https://github.com/ceph/ceph/pull/62782 and this commit represents one
of what will be at least twenty-five other commits made to track this
error down.

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

doc/rados: edit balancer.rst

Edit doc/rados/operations/balancer.rst. Follow up on matters raised in
https://github.com/ceph/ceph/pull/63530. Make the English clearer.

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

doc/mgr: edit iostat.rst

Rewrite the first sentence in doc/mgr/iostat.rst. This follows up on a
request made by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63418#discussion_r2102806688.

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

Merge pull request #63657 from zdover23/wip-doc-2025-06-03-backport-63633-to-squid

squid: doc/mgr: edit progress.rst

Merge pull request #63660 from zdover23/wip-doc-2025-06-03-backport-63632-to-squid

squid: doc/dev/cephfs-mirroring: edit file 4 of x

Merge pull request #63663 from zdover23/wip-doc-2025-06-03-backport-63631-to-squid

squid: doc/mgr: edit nfs.rst

Merge pull request #63666 from zdover23/wip-doc-2025-06-03-backport-63630-to-squid

squid: doc/mgr: edit modules.rst

Merge pull request #63669 from zdover23/wip-doc-2025-06-03-backport-63629-to-squid

squid: doc/mgr: edit localpool.rst

doc/mgr: edit localpool.rst

Remove "only" where it was extraneous.

This commit was made in response to a request made by Anthony D'Atri
here: https://github.com/ceph/ceph/pull/63419#discussion_r2102803276.

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

doc/mgr: edit modules.rst

s/called/named/ as requested by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63451#discussion_r2104487962.

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

doc/mgr: edit nfs.rst

Edit the "Updating an NFS Cluster" section of doc/mgr/nfs.rst. This
commit includes changes requested by Anthony D'Atri in
https://github.com/ceph/ceph/pull/63452.

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

doc/dev/cephfs-mirroring: edit file 4 of x

Add prompts (and perform necessary corrections to glaring grammatical
errors) to doc/dev/cephfs-mirroring.rst, as requested by Jos Collin in
https://github.com/ceph/ceph/pull/63237/files#r2085886075.

This commit edits the fourth (and final) quarter of the
doc/dev/cephfs-mirroring.rst file.

Further refinements to the English in this file are possible.

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

doc/mgr: edit progress.rst

Edit doc/mgr/progress.rst. Make the changes suggested by Anthony D'Atri
in https://github.com/ceph/ceph/pull/63470.

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

doc/rados/operations: Improve placement-groups.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit ddf0cb79e51708fc89f644421ed92aa3586ecef4)

Merge pull request #62650 from aaSharma14/wip-70777-squid

squid: mgr/dashboard: add prometheus read permission to cluster_mgr role

Reviewed-by: Afreen Misbah <afreen@ibm.com>

Merge pull request #63477 from rhcs-dashboard/wip-71364-squid

squid: mgr/dashboard: accept dot(.) in user_id & restrict tenant validation in user form

Reviewed-by: Aashish Sharma <aasharma@redhat.com>

Merge pull request #63625 from zdover23/wip-doc-2025-06-02-backport-63481-to-squid

squid: doc/mgr: Small improvements in rgw.rst

doc/mgr: Small improvements in rgw.rst

Use double backticks consistently for module name, CLI commands and
parameters etc.

Use title case in section titles and underline them only until end of
title text.

Use "command line" instead of "cmd line" in text.

Capitalize RGW consistently.

Delete one paragraph that included a strange out of place text fragment.

Call it "Manager" consistently instead of "MGR" in text one time.

Improve language in CA cert upgrade.

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

Merge pull request #63589 from zdover23/wip-doc-2025-05-29-backport-63471-to-squid

squid: doc/mgr: edit prometheus.rst

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

Merge branch 'squid' into wip-doc-2025-05-29-backport-63471-to-squid

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

Merge pull request #63577 from zdover23/wip-doc-2025-05-29-backport-63451-to-squid

squid: doc/mgr: edit modules.rst.

Merge pull request #63586 from zdover23/wip-doc-2025-05-29-backport-63470-to-squid

squid: doc/mgr: edit progress.rst

Merge pull request #63583 from zdover23/wip-doc-2025-05-29-backport-63469-to-squid

squid: doc/mgr: edit orchestrator.rst

Merge pull request #63611 from zdover23/wip-doc-2025-05-30-backport-63475-to-squid

squid: doc/mgr: edit telegraf.rst

Merge pull request #62930 from zdover23/wip-doc-2025-04-23-backport-62696-to-squid

squid: doc/mgr: Improve prometheus.rst

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

Merge pull request #63448 from zdover23/wip-doc-2025-05-23-backport-63446-to-squid

squid: doc/radosgw: Cosmetic improvements in cloud-transition.rst

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

doc/mgr: edit telegraf.rst

Edit doc/mgr/telegraf.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

Merge pull request #63580 from zdover23/wip-doc-2025-05-29-backport-63452-to-squid

squid: doc/mgr: edit nfs.rst

Merge pull request #63592 from zdover23/wip-doc-2025-05-29-backport-63472-to-squid

squid: doc/mgr: edit rgw.rst

doc/mgr: edit rgw.rst

Edit doc/mgr/rgw.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

doc/mgr: edit prometheus.rst

Edit doc/mgr/prometheus.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

doc/mgr: edit progress.rst

Edit doc/mgr/progress.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

doc/mgr: edit orchestrator.rst

Edit doc/mgr/orchestrator.rst.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

doc/mgr: edit nfs.rst

Edit doc/mgr/nfs.rst. Improve some of the English.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

This commit and the PR of which it is a part includes the changes made
in https://github.com/ceph/ceph/pull/62782 and some corrections to
glaring grammatical errors. However, this file could use a careful
grammar pass.

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

doc/mgr: edit modules.rst.

Edit doc/mgr/modules.rst. Improve some of the English.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

This commit and the PR of which it is a part includes the changes made
in https://github.com/ceph/ceph/pull/62782 and some corrections to
glaring grammatical errors. However, this file could use a careful
grammar pass. As it currently stands, it contains run-on sentences and
English that is acceptable in conversation but not acceptable in written
communication.

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

Merge pull request #63052 from pritha-srivastava/wip-71107-squid

squid: rgw/sts: Implementation of validating JWT using modulus and exponent

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #63030 from soumyakoduri/wip-skoduri-squid

[squid] RGW backports

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62954 from cbodley/wip-71061-squid

squid: qa/rgw: run verify tests with garbage collection disabled

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62884 from ivancich/wip-70981-squid

squid: rgw: prevent crash in `radosgw-admin bucket object shard ...`

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #62740 from jzhu116-bloomberg/wip-70637-squid

squid: rgw: revert PR #41897 to allow multiple delete markers to be created

Reviewed-by: Adam Emerson <aemerson@redhat.com>

Merge pull request #63535 from zdover23/wip-doc-2025-05-28-backport-63530-to-squid

squid: doc/rados/operations: Add settings advice to balancer.rst

Merge pull request #63538 from zdover23/wip-doc-2025-05-28-backport-63255-to-squid

squid: doc/mgr: edit crash.rst

Merge pull request #63541 from zdover23/wip-doc-2025-05-28-backport-63253-to-squid

squid: doc/monitoring: correct list formatting

Merge pull request #63544 from zdover23/wip-doc-2025-05-28-backport-63254-to-squid

squid: doc/cephfs: correct reference structure in fs-volumes.rst

Merge pull request #63547 from zdover23/wip-doc-2025-05-28-backport-63275-to-squid

squid: doc/dev/cephfs-mirroring: edit file 3 of x

Merge pull request #63550 from zdover23/wip-doc-2025-05-28-backport-63419-to-squid

squid: doc/mgr: edit localpool.rst

doc/mgr: edit localpool.rst

Edit doc/mgr/localpool.rst. Improve the English where necessary.

This is part of a project to separate out the twenty-five files that
were committed to https://github.com/ceph/ceph/pull/62782.

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

doc/dev/cephfs-mirroring: edit file 3 of x

Add prompts (and perform necessary corrections to glaring grammatical
errors) to doc/dev/cephfs-mirroring.rst, as requested by Jos Collin in
https://github.com/ceph/ceph/pull/63237/files#r2085886075.

This commit edits the third quarter of the doc/dev/cephfs-mirroring.rst
file. This commit edits down to the line beginning "`Peers` section in
the command output".

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

doc/cephfs: correct reference structure in fs-volumes.rst

Correct the links to cross-references in the cases of the following two
directives:

1. pause-clone-threads
2. pause-purge-threads

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

doc/monitoring: correct list formatting

Correct list formatting in doc/monitoring/index.rst.

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

doc/mgr: edit crash.rst

Edit doc/mgr/crash.rst. Add prompts and correct some of the inelegant
English present in the file.

This commit is part of a project to separate out the twenty-five files
that were committed to https://github.com/ceph/ceph/pull/62782.

Credit for this initiative should go to Ville Ojamo.

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

doc/rados/operations: Add settings advice to balancer.rst

Signed-off-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
(cherry picked from commit f188003530e55f6ac46ab3d56c53fab65cdb7e7c)

Merge pull request #63234 from nbalacha/wip-71240-squid

squid: cls/rbd: write image mirror status if state is CREATING

Reviewed-by: Ilya Dryomov <idryomov@redhat.com>

Merge pull request #63492 from zdover23/wip-doc-2025-05-27-backport-63420-to-squid

squid: doc/mgr: edit mds_autoscaler.rst