Skip to content

Remove Vale errors and use more flexible rules#1092

Open
tr0njavolta wants to merge 8 commits intoupbound:mainfrom
tr0njavolta:vale-pass
Open

Remove Vale errors and use more flexible rules#1092
tr0njavolta wants to merge 8 commits intoupbound:mainfrom
tr0njavolta:vale-pass

Conversation

@tr0njavolta
Copy link
Member

Description

Vale check returns warnings and errors but make lint lints all files. This PR attempts to add some exceptions to current docs, remove overly restrictive rules (like allowing minimize to pass "wordiness" checks, for example)

Type of change

  • Bug fix (typo, broken link, incorrect info)
  • Content update (new info, clarification, reorganization)
  • New content (new page, section, or guide)

Checklist

  • I ran make vale-file FILE=docs/path/to/file.md locally for files changed (or will fix Vale suggestions in review)
  • Links work and point to the right places
  • If this adds new content, I tested the examples/instructions

Additional notes

tr0njavolta and others added 6 commits February 25, 2026 16:22
Signed-off-by: Rae Sharp <resharp20@gmail.com>
- Fixed uppercase acronyms: add backticks to BCDR, SLSA, OTLP, DST, CUE, CEL
- Replaced passive voice constructions with active voice throughout
- Removed weasel words: easily, safely, quickly, roughly, completely, etc.
- Changed future tense (will) to present tense (e.g., 'will always' -> 'always')
- Removed first-person plural pronouns: our/we/us replaced with specific language
- Fixed WordList issues: admin -> administrator, in order to -> to
- Shortened long sentences (>25 words) by breaking them into shorter units
- Fixed wor dy phrases: In the case of -> For, a number of -> multiple, etc.
- Wrapped technical/reference content in Vale exceptions where appropriate
- Updated 30+ documentation files across CLI, Platform, Spaces, UXP, and Reference sections

Remaining warnings (206): Mostly in api-connector.md, authentication.md, and other technical reference files where passive voice and complex sentences are necessary for technical accuracy.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Feb 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 26, 2026 4:38am

Request Review

@tr0njavolta tr0njavolta changed the title Vale Warnings Remove Vale errors and use more flexible rules Feb 26, 2026
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