This directory contains utilities for testing the documentation validation workflows locally.
The test-vale.sh script is designed to validate that the Vale integration in the unified documentation workflow functions correctly. This script simulates the GitHub Actions environment and tests the full Vale style checking approach, including:
- Installation of Vale using the same method as the workflow
- Basic Vale execution and verification
- JSON output format validation
- Chunked processing of multiple files (as implemented in the workflow)
To run the Vale integration test:
cd .github/docs/testing
./test-vale.sh- Validates that Vale can be properly installed and run
- Confirms that Vale produces valid JSON output
- Tests the chunked processing approach used in the workflow
- Verifies the JSON results combination logic
Run this test when:
- Making changes to the Vale integration in the docs-core action
- Upgrading the Vale version used in the workflow
- Modifying the Vale configuration or style rules
- Troubleshooting Vale-related issues in the GitHub Actions environment
The Vale integration in our workflow has two components:
- Installation in the parent workflow (
docs-unified.yaml) - Execution in the docs-core composite action
This approach ensures that Vale is properly installed and accessible to the composite action without requiring it to download and install Vale itself, which could be unreliable within the composite action context.