Always include clear comments explaining the reasoning behind CI workflow decisions, including test environment separation, version matrix choices, and build requirements. This prevents confusion about when different workflows should be used and helps maintain consistency across the team.
Always include clear comments explaining the reasoning behind CI workflow decisions, including test environment separation, version matrix choices, and build requirements. This prevents confusion about when different workflows should be used and helps maintain consistency across the team.
For test workflows, clearly distinguish between development tests (fast, no build required) and production tests (with build artifacts). For version matrices, document the purpose of each version selection:
node:
# Latest even version
- "20"
# Minimal version for development
- "16"
include:
- os: "ubuntu-latest"
# Pick a version that is fast (normally highest LTS version)
node: "18"
ENABLE_CODE_COVERAGE: true
This documentation helps developers understand which workflow to modify for different types of changes and prevents misplacement of build-dependent steps in development test workflows.
Enter the URL of a public GitHub repository