Skip to content

fix: remove duplicate link key in 027-non-descriptive-link-text.yml#198

Closed
yanksyoon wants to merge 1 commit into
canonical:mainfrom
yanksyoon:fix/duplicate-link-key-027
Closed

fix: remove duplicate link key in 027-non-descriptive-link-text.yml#198
yanksyoon wants to merge 1 commit into
canonical:mainfrom
yanksyoon:fix/duplicate-link-key-027

Conversation

@yanksyoon
Copy link
Copy Markdown
Member

Problem

styles/Canonical/027-non-descriptive-link-text.yml contains two link: keys:

link: https://canonical-documentation-style-guide.readthedocs-hosted.com/
link: https://docs.ubuntu.com/styleguide/en

Duplicate keys are invalid YAML. go-yaml (used by Vale) silently discards the first value, leaving extends unreadable. This causes Vale to abort with a misleading error:

E201 'extends' key must be one of [capitalization conditional consistency existence ...]

The real cause is the YAML parse failure, not an invalid extends value.

Fix

Remove the duplicate link: line, keeping the canonical documentation style guide URL as the single reference.

Impact

This issue breaks the docs-checks / vale CI job in any repository that transitively pulls this style file (e.g. via canonical/platform-engineering-vale-package).

The file had two 'link:' keys which is invalid YAML — go-yaml silently
parses the second value, leaving 'extends' unreadable and causing Vale
to abort with a misleading E201 error:

  'extends' key must be one of [capitalization conditional ...]

Remove the duplicate link, keeping the canonical documentation style
guide URL as the single reference.
@yanksyoon yanksyoon closed this May 19, 2026
@yanksyoon yanksyoon force-pushed the fix/duplicate-link-key-027 branch from a2cfdab to 61a584f Compare May 19, 2026 11:23
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