Skip to content

Fix AsciiDocDITA.ConceptLink Vale errors#114773

Open
jab-rh wants to merge 1 commit into
openshift:mainfrom
jab-rh:OSDOCS-17049pr5
Open

Fix AsciiDocDITA.ConceptLink Vale errors#114773
jab-rh wants to merge 1 commit into
openshift:mainfrom
jab-rh:OSDOCS-17049pr5

Conversation

@jab-rh

@jab-rh jab-rh commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Move rogue body links and xrefs into Additional resources sections across 13 assemblies and concept modules to satisfy DITA link placement rules.

Address Vale bot attribute and terminology suggestions

Replace plain-text product terms with AsciiDoc attributes and use {sno} instead of the avoided SNO abbreviation in cluster-tasks and storage docs.

Fix AsciiDocDITA.ShortDescription Vale errors in post-install filelist batch

Add user-focused [role="_abstract"] short descriptions to assemblies and modules so DITA migration checks pass and readers get clearer link previews.

Version(s):

Issue:

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:

Move rogue body links and xrefs into Additional resources sections across
13 assemblies and concept modules to satisfy DITA link placement rules.

Address Vale bot attribute and terminology suggestions

Replace plain-text product terms with AsciiDoc attributes and use {sno}
instead of the avoided SNO abbreviation in cluster-tasks and storage docs.

Fix AsciiDocDITA.ShortDescription Vale errors in post-install filelist batch

Add user-focused [role="_abstract"] short descriptions to assemblies and modules so DITA migration checks pass and readers get clearer link previews.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jab-rh jab-rh added this to the Continuous Release milestone Jul 7, 2026
@jab-rh jab-rh self-assigned this Jul 7, 2026
@openshift-ci openshift-ci Bot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Jul 7, 2026
@ocpdocs-previewbot

Copy link
Copy Markdown

🤖 Tue Jul 07 16:10:55 - Prow CI generated the docs preview:
https://114773--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

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.DocumentTitle: The document title (=) is missing.


[id="post-install-deploy-OCS"]
== Deploy Red Hat OpenShift Data Foundation
== Deploy {rh-storage-first}

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.AssemblyContents: Content other than additional resources cannot follow include directives.

@openshift-ci

openshift-ci Bot commented Jul 7, 2026

Copy link
Copy Markdown

@jab-rh: all tests passed!

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

branch/enterprise-4.20 branch/enterprise-4.21 branch/enterprise-4.22 size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants