docs-v2/.github/scripts
Jason Stirnaman 1cea1dd9f8
feat(ci): add Vale style check workflow (#6816)
* docs(ci): add Vale CI integration design

Design for adding Vale style linting to GitHub Actions PR checks:
- Block merging on style errors
- Inline annotations + PR summary comments
- Smart config detection per product area
- Shared content resolution script (reusable by other workflows)
- Docker-based Vale execution (matches local setup)

* docs(ci): add Vale CI implementation plan

Detailed step-by-step plan for implementing Vale CI:
- Task 1: Shared content resolution script
- Task 2: Vale check script with config mapping
- Task 3: GitHub Actions workflow
- Task 4: Testing procedure
- Task 5: Documentation updates
- Task 6: Final verification

* feat(ci): add shared content resolution script

Resolves content/shared/* files to their consuming product pages
by searching for matching source: frontmatter. Reusable by Vale,
link-checker, and other workflows that need shared content expansion.

* feat(ci): add Vale check script with config mapping

Maps files to product-specific Vale configs matching lefthook.yml:
- cloud-dedicated, cloud-serverless, v2 use product configs
- Other content uses root .vale.ini
- Non-content uses .vale-instructions.ini

Runs Vale via Docker for version consistency with local dev.

* feat(ci): add Vale style check workflow

Runs Vale on PR changes with product-specific configs:
- Blocks merging on errors
- Shows warnings/suggestions as annotations
- Posts summary comment for humans and AI agents
- Uses Docker for Vale version consistency

* test(ci): add temporary file to test Vale workflow

* test(ci): remove Vale test file

* docs: add Vale CI section to DOCS-TESTING.md

* fix(ci): handle files without trailing newline in vale-check.sh

Add `|| [[ -n "$f" ]]` to while read loops to catch the last line
even when input doesn't end with a newline. This is a common bash
pitfall where `while read` skips the final line without a terminator.

* Delete docs/plans/2026-02-11-vale-ci-design.md

Migrated design to PR description

* Delete docs/plans/2026-02-11-vale-ci-implementation.md

Migrated implementation summary to PR description
2026-03-27 21:05:14 -05:00
..
utils fix: resolve code review findings:1. Fixed Cypress Race Condition: Moved logging 2025-07-28 16:24:24 -05:00
cache-manager.cjs ci: convert cypress scripts to CommonJS: 2025-07-28 21:58:09 -05:00
cache-manager.js fix: resolve code review findings:1. Fixed Cypress Race Condition: Moved logging 2025-07-28 16:24:24 -05:00
comment-generator.js fix: apply code review suggestions: High Priority Issues (Fixed): 2025-07-28 16:24:24 -05:00
detect-preview-pages.js Fix PR preview and Copilot visual review skipping docs home page when layouts/index.html changes (#6922) 2026-03-13 08:47:38 -05:00
incremental-validator.cjs ci: convert cypress scripts to CommonJS: 2025-07-28 21:58:09 -05:00
incremental-validator.js fix: resolve code review findings:1. Fixed Cypress Race Condition: Moved logging 2025-07-28 16:24:24 -05:00
link-extractor.cjs ci: convert cypress scripts to CommonJS: 2025-07-28 21:58:09 -05:00
link-extractor.js Apply suggestions from code review 2025-07-28 16:24:24 -05:00
matrix-generator.js ci: convert cypress scripts to CommonJS: 2025-07-28 21:58:09 -05:00
parse-pr-urls.js Fix PR preview and Copilot visual review skipping docs home page when layouts/index.html changes (#6922) 2026-03-13 08:47:38 -05:00
prepare-preview-files.js refactor(ci): improve PR preview with products.yml and index page (#6656) 2025-12-19 12:12:20 -06:00
preview-comment.js Add URL aliases for Docker Hub links to influxdb3 serve documentation (#6895) 2026-03-26 16:10:40 -05:00
resolve-review-urls.js Add URL aliases for Docker Hub links to influxdb3 serve documentation (#6895) 2026-03-26 16:10:40 -05:00
resolve-shared-content.sh feat(ci): add Vale style check workflow (#6816) 2026-03-27 21:05:14 -05:00
test-parse-pr-urls.js Fix PR preview and Copilot visual review skipping docs home page when layouts/index.html changes (#6922) 2026-03-13 08:47:38 -05:00
vale-check.sh feat(ci): add Vale style check workflow (#6816) 2026-03-27 21:05:14 -05:00
workflow-utils.js feat(ci): add doc review pipeline with auto-labeling and Copilot review (#6890) 2026-03-09 20:22:31 -05:00