Skip to content

Enable DITA validation rules for Vale on rhacs-docs-main#108476

Open
kcarmichael08 wants to merge 1 commit intoopenshift:rhacs-docs-mainfrom
kcarmichael08:enable-dita-vale-validation
Open

Enable DITA validation rules for Vale on rhacs-docs-main#108476
kcarmichael08 wants to merge 1 commit intoopenshift:rhacs-docs-mainfrom
kcarmichael08:enable-dita-vale-validation

Conversation

@kcarmichael08
Copy link
Contributor

@kcarmichael08 kcarmichael08 commented Mar 17, 2026

Version(s): main, no cherry picks

Issue: https://redhat.atlassian.net/browse/ROX-33629

Link to docs preview:

QE review: N/A

  • QE has approved this change.

Additional information:

Aligns the Vale configuration with the main branch to enable AsciiDoc DITA validation rules. This enables automated PR review comments for DITA compliance issues through the Prow vale-review job.

Changes:

  • Fix Packages line syntax (add missing comma)
  • Add Vocab = OpenShiftDocs
  • Remove AsciiDocDITA from BasedOnStyles (rules applied via explicit configuration)
  • Enable 23 DITA rules at error level (AdmonitionTitle, AssemblyContents, AuthorLine, BlockTitle, CalloutList, ContentType, DiscreteHeading, DocumentID, DocumentTitle, EntityReference, EquationFormula, ExampleBlock, LineBreak, MismatchedID, NestedSection, PageBreak, RelatedLinks, ShortDescription, SidebarBlock, TableFooter, TaskContents, TaskProcedure, TaskTitle)
  • Enable RedHat.ReleaseNotes = NO

These changes ensure that DITA validation errors are caught during PR reviews, improving documentation quality for DITA conversion readiness.

Aligns the Vale configuration with the main branch to enable AsciiDoc DITA validation rules. This enables automated PR review comments for DITA compliance issues through the Prow vale-review job.

Changes:
- Fix Packages line syntax (add missing comma)
- Add Vocab = OpenShiftDocs
- Remove AsciiDocDITA from BasedOnStyles (rules applied via explicit configuration)
- Enable 23 DITA rules at error level (AdmonitionTitle, AssemblyContents, AuthorLine, BlockTitle, CalloutList, ContentType, DiscreteHeading, DocumentID, DocumentTitle, EntityReference, EquationFormula, ExampleBlock, LineBreak, MismatchedID, NestedSection, PageBreak, RelatedLinks, ShortDescription, SidebarBlock, TableFooter, TaskContents, TaskProcedure, TaskTitle)
- Enable RedHat.ReleaseNotes = NO

These changes ensure that DITA validation errors are caught during PR reviews, improving documentation quality for DITA conversion readiness.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@openshift-ci openshift-ci bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Mar 17, 2026
@kcarmichael08 kcarmichael08 added the RHACS Label for RHACS related PRs that go in the rhacs-docs branch label Mar 17, 2026
@ocpdocs-previewbot
Copy link

🤖 Tue Mar 17 15:51:41 - Prow CI generated the docs preview:

https://108476--ocpdocs-pr.netlify.app/

@openshift-ci
Copy link

openshift-ci bot commented Mar 17, 2026

@kcarmichael08: 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

RHACS Label for RHACS related PRs that go in the rhacs-docs branch size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants