Skip to content

Fix ConceptLink warnings in virt/managing_vms#111391

Open
abrennan89 wants to merge 1 commit intoopenshift:mainfrom
abrennan89:fix-concept-links-managing-vms
Open

Fix ConceptLink warnings in virt/managing_vms#111391
abrennan89 wants to merge 1 commit intoopenshift:mainfrom
abrennan89:fix-concept-links-managing-vms

Conversation

@abrennan89
Copy link
Copy Markdown
Contributor

Move links and cross-references to Additional resources sections. Update link text for proper capitalization and formatting.

Version(s):

Issue:

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:

@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 7, 2026
@ocpdocs-previewbot
Copy link
Copy Markdown

ocpdocs-previewbot commented May 7, 2026

🤖 Fri May 08 18:43:46 - Prow CI generated the docs preview:
https://111391--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

Comment thread virt/managing_vms/advanced_vm_management/virt-configuring-virtual-gpus.adoc Outdated
.Procedure

Follow link:https://developers.redhat.com/learning/learn:manage-openshift-virtual-machines-gitops/resource/resources:connect-and-configure-external-repository-argo-cd-virtual-machines[the _Manage OpenShift virtual machines with GitOps_ learning path] in performing these steps:
Follow the _Manage OpenShift virtual machines with GitOps_ learning path in performing these steps:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

🤖 [error] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Outside scope of this PR

* OpenShift GitOps documentation

[role="_additional-resources"]
== Additional resources
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

🤖 [error] AsciiDocDITA.TaskSection: Sections are not allowed in DITA tasks.

Comment thread virt/managing_vms/advanced_vm_management/virt-schedule-vms.adoc Outdated
Comment thread virt/managing_vms/virtual_disks/virt-configuring-shared-volumes-for-vms.adoc Outdated
Comment thread virt/managing_vms/virtual_disks/virt-configuring-shared-volumes-for-vms.adoc Outdated
@abrennan89 abrennan89 force-pushed the fix-concept-links-managing-vms branch from fd1a266 to 3f81e1f Compare May 8, 2026 16:24
Comment thread virt/managing_vms/advanced_vm_management/virt-assigning-compute-resources.adoc Outdated
Comment thread virt/managing_vms/advanced_vm_management/virt-configuring-virtual-gpus.adoc Outdated
Comment thread virt/managing_vms/advanced_vm_management/virt-configuring-virtual-gpus.adoc Outdated
Comment thread virt/managing_vms/advanced_vm_management/virt-high-availability-for-vms.adoc Outdated
Comment thread virt/managing_vms/virt-accessing-vm-ssh.adoc Outdated
Comment thread virt/managing_vms/virt-accessing-vm-ssh.adoc Outdated
Comment thread virt/managing_vms/virt-customize-web-console.adoc Outdated
Comment thread virt/managing_vms/virt-edit-vms.adoc Outdated
Comment thread virt/managing_vms/virt-exporting-vms.adoc Outdated

[role="_additional-resources"]
.Additional resources
== Additional resources
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

🤖 [error] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.

@abrennan89 abrennan89 force-pushed the fix-concept-links-managing-vms branch from fc3682d to a5ef36c Compare May 8, 2026 17:30
Move links and cross-references to Additional resources sections to
resolve ConceptLink warnings in the managing_vms directory.

Changes:
- Moved 37 links/xrefs across 17 files
- Added [role="_additional-resources"] attributes where needed
- Added [id="additional-resources_{context}"] to all Additional resources sections
- Created or updated Additional resources sections
- Preserved guide references (in the _Guide Name_ guide)
- Preserved all empty lines, including between include statements

Text formatting improvements:
- Wrapped document/guide titles in quotation marks when referenced
- Used {VirtProductName} variable instead of hardcoded product names
- Maintained proper capitalization in link text
- Removed unnecessary self-referential xrefs
- Removed deprecated role attributes

Files modified:
- advanced_vm_management/virt-NUMA-topology.adoc
- advanced_vm_management/virt-about-multi-queue.adoc
- advanced_vm_management/virt-assigning-compute-resources.adoc
- advanced_vm_management/virt-configuring-virtual-gpus.adoc
- advanced_vm_management/virt-high-availability-for-vms.adoc
- advanced_vm_management/virt-managing-virtual-machines-by-using-openshift-gitops.adoc
- advanced_vm_management/virt-schedule-vms.adoc
- virt-accessing-vm-ssh.adoc
- virt-controlling-vm-states.adoc
- virt-customize-web-console.adoc
- virt-edit-vms.adoc
- virt-exporting-vms.adoc
- virt-manage-vmis.adoc
- virt-managing-vms-openshift-pipelines.adoc
- virt-using-vtpm-devices.adoc
- virtual_disks/virt-configuring-shared-volumes-for-vms.adoc
- virtual_disks/virt-hot-plugging-virtual-disks.adoc

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@abrennan89 abrennan89 force-pushed the fix-concept-links-managing-vms branch from a5ef36c to 350497c Compare May 8, 2026 18:36
@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented May 8, 2026

@abrennan89: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
ci/prow/validate-portal 350497c link true /test validate-portal

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

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

Labels

size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants