Skip to content

Conversation

nodeg
Copy link
Member

@nodeg nodeg commented Oct 18, 2025

Description

This PR includes fixes for some issues I found while taking a look at the documentation. Each fix is put into its own commit with a changelog entry. Please take a look at the commits.

Examples

image image image

Target branches

  • master (probably)
  • 5.1 (this PR)
  • 5.0 (probably)

nodeg added 2 commits October 18, 2025 15:11
The wording on the preface page does not match what we have on the left
hand side natigation menu.
@nodeg nodeg self-assigned this Oct 18, 2025
@nodeg nodeg requested a review from Copilot October 19, 2025 10:59
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates documentation and navigation references across the Reference and Installation/Upgrade guides, and records the changes in the changelog.

  • Add Antora-compatible xref syntax (with []) to System Details links
  • Update revdates for affected pages
  • Update Installation/Upgrade overview section names and add corresponding changelog entries

Reviewed Changes

Copilot reviewed 3 out of 6 changed files in this pull request and generated 2 comments.

File Description
modules/reference/pages/systems/system-details/sd-details.adoc Fix xref links by adding [] for proper Antora rendering and update revdate
modules/installation-and-upgrade/pages/installation-and-upgrade-overview.adoc Adjust section names for clarity/consistency and update revdate
CHANGELOG.md Add entries describing the documentation fixes and updates

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@@ -1,3 +1,8 @@
- Updated the admin_* screenshots in multiple sections
- Aligned the preface section to match the navigation in
Installation and Upgrade Guide
Copy link

Copilot AI Oct 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammar: add the definite article. It should read 'in the Installation and Upgrade Guide.'

Suggested change
Installation and Upgrade Guide
the Installation and Upgrade Guide

Copilot uses AI. Check for mistakes.

- Aligned the preface section to match the navigation in
Installation and Upgrade Guide
- Fixed the broken references for the system details pages
in Reference Guide
Copy link

Copilot AI Oct 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammar: add the definite article. It should read 'in the Reference Guide.'

Suggested change
in Reference Guide
in the Reference Guide

Copilot uses AI. Check for mistakes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant