Skip to content

[DOCS-15413] Suppress prodname frontmatter noise in Vale CI annotations - #39285

Draft
hestonhoffman wants to merge 2 commits into
masterfrom
heston/prodname-rule
Draft

[DOCS-15413] Suppress prodname frontmatter noise in Vale CI annotations#39285
hestonhoffman wants to merge 2 commits into
masterfrom
heston/prodname-rule

Conversation

@hestonhoffman

@hestonhoffman hestonhoffman commented Aug 18, 2026

Copy link
Copy Markdown
Collaborator

What does this PR do? What is the motivation?

Adding some Vale workarounds to support adding and checking for the Product name shortcode.

  • Adds the BlockIgnores entry for the prodname shortcode span to .vale.ini. This prevents terms that are already encapsulated with the shortcode from flagging as false positives; Vale doesn't support this kind of exclusion.
  • Updates vale_annotations.py so CI-generated PR annotations drop Datadog.Prodname findings that fall inside YAML frontmatter.

This is a code-only split out of a larger effort to wrap existing product names in the prodname shortcode; the content changes will follow in separate batched PRs.
See:

Merge readiness

  • Ready for merge

Vale's Datadog.Prodname rule correctly flags product names in YAML
frontmatter, but Hugo shortcodes don't render inside raw YAML string
values, so wrapping them there isn't actionable. This drops those
specific findings from the GitHub annotation output without touching
.vale.ini, so the rule still runs everywhere else (including for
other tools that consume Vale directly, e.g. the VSCode extension).
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Aug 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant