Skip to content

doc: update microceph cross references#1363

Merged
roosterfish merged 1 commit into
canonical:mainfrom
elijahgreenstein:microceph-cross-references
Apr 30, 2026
Merged

doc: update microceph cross references#1363
roosterfish merged 1 commit into
canonical:mainfrom
elijahgreenstein:microceph-cross-references

Conversation

@elijahgreenstein
Copy link
Copy Markdown
Contributor

@elijahgreenstein elijahgreenstein commented Apr 28, 2026

MicroCeph PR 719 adds reference labels to many documentation headings. Where possible, this PR updates cross references to MicroCeph documentation from doc to ref roles to use those labels.

This PR also updates one LXD cross reference to a ref role.

Checklist

MicroCeph PR 719 adds reference labels to many documentation headings.
Where possible, this commit updates cross references to MicroCeph
documentation from `doc` to `ref` roles to use those labels. This commit
also updates one LXD cross reference to a `ref` role.

Refer to canonical/microceph#719

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
@github-actions github-actions Bot added the Documentation Documentation needs updating label Apr 28, 2026
@elijahgreenstein
Copy link
Copy Markdown
Contributor Author

This PR will be ready after canonical/microceph#719 is merged.

@roosterfish
Copy link
Copy Markdown
Contributor

@elijahgreenstein nice thanks for picking this up so quickly.

@elijahgreenstein elijahgreenstein marked this pull request as ready for review April 29, 2026 19:31
@elijahgreenstein
Copy link
Copy Markdown
Contributor Author

Should be all set now that 719 was merged in MicroCeph.

@roosterfish roosterfish merged commit 3708638 into canonical:main Apr 30, 2026
23 of 24 checks passed
@elijahgreenstein elijahgreenstein deleted the microceph-cross-references branch May 21, 2026 17:29
roosterfish added a commit that referenced this pull request May 28, 2026
This PR backports documentation updates from commits
15e4e54 to
3df4f0a (PRs #1362 , #1364, #1368,
#1371, #1374, #1382, and #1389), with two exceptions:

- Commit 1c8c8f8 (from #1363) was not
backported. That commit added cross references to MicroCeph reference
labels that were added to the MicroCeph documentation (see
canonical/microceph#719). The MicroCloud 2
documentation, however, builds older versions of the MicroCeph
documentation that do not include the reference labels. (cf. the
discussion in #1344).
- Commit 9626a1b (from #1368) was not
backported. That commit involved configuration of the Swagger UI, which
is not used in MicroCloud 2.

Most of the commits in this backport are from the tooling update in
#1368. A few edits were made:

- `doc/conf.py` was amended to remove the `html_extra_path`, which is
used for Cluster Manager--specific documentation in version 3.
- URLs for LXD, MicroCeph, and MicroOVN were amended to use the pinned
versions (`stable-v5.21`, `v19.2.0-squid` and `24.03`, respectively).
- Swagger UI related tooling was removed (specific to MicroCloud 3).
- A note on snap channels was edited to refer to the LTS release, rather
than the feature release.

## Checklist

- [x] I have read the [contributing
guidelines](https://github.com/canonical/microcloud/blob/main/CONTRIBUTING.md)
and attest that all commits in this PR are [signed
off](https://github.com/canonical/microcloud/blob/main/CONTRIBUTING.md#including-a-signed-off-by-line-in-your-commits),
[cryptographically
signed](https://github.com/canonical/microcloud/blob/main/CONTRIBUTING.md#commit-signature-verification),
and follow this project's [commit
structure](https://github.com/canonical/microcloud/blob/main/CONTRIBUTING.md#commit-structure).
- [x] I have checked and added or updated relevant documentation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Documentation needs updating

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants