fix(vale): update (vale sync), improve rules, exclude URLs and shortcode attributes from spell checking (#6798)
* fix(vale): improve spelling and heading rules for Google style compliance
Spelling improvements:
- Exclude fenced code blocks (~code) and inline code (~raw) from checking
- Add filters for URL paths, full URLs, and shortcode attributes
- Prevents false positives on code syntax and API endpoints
Capitalization improvements:
- Add InfluxDB product exceptions (InfluxDB, InfluxQL, Telegraf, etc.)
- Add common technical acronyms (API, CLI, SQL, HTTP, JSON, etc.)
- Add cloud provider names (AWS, GCP, Azure, S3)
- Add link to Google style guide for sentence case headings
Aligns with Google Developer Documentation Style Guide:
https://developers.google.com/style/capitalization
https://claude.ai/code/session_0173AuWPoy6UXiatCMGz4W7h
* fix(vale): reduce false positives, add custom Units rule and linting skill
- Disable Vale.Terms to prevent false positives from URLs/paths
- Create InfluxDataDocs.Units rule that allows duration literals (30d, 24h)
while still validating byte units (GB, TB)
- Disable write-good.TooWordy for technical terms (aggregate, expiration)
- Add TokenIgnores for URL paths and inline code patterns
- Expand spelling ignore list with technical terms (subprocess, CPUs, etc.)
- Sync Google style packages via vale sync
Documentation improvements:
- Add new vale-linting skill with comprehensive workflow
- Update content-editing skill with Vale section
- Enhance ci-automation-engineer agent with Vale expertise
- Add Vale troubleshooting to copilot-instructions.md
- Add shell command permissions to settings.json
Reduces Vale warnings from 794 to 187 (76% reduction) while keeping
useful style validation active.
* Update .ci/vale/styles/Google/Quotes.yml
* Update .claude/skills/vale-linting/SKILL.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update .claude/agents/ci-automation-engineer.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Update .ci/vale/styles/Google/Colons.yml
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* chore(deps): bump axios to address vuln
---------
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
f59250fd9c