Skip to content

feat(ci): add docs:validate job for deploy/docs MR pipeline coverage

Jérôme Revillard requested to merge fix/docs-validate-ci-job into main

Closes #824 (closed) (pipeline coverage)

Problem

MRs that only modify deploy/ansible/ or docs/ files trigger no CI pipeline because no job's changes: rules match these paths. GitLab blocks merge with 'Pipeline must succeed' — docs-only MRs are stuck.

Changes

.gitlab-ci.yml — New docs:validate job (lint stage)

Lightweight validation for deploy/docs changes:

  • ansible-playbook --syntax-check on deploy.yml and deploy-gpu.yml
  • yamllint on deploy/ansible/ YAML files
  • Follows existing dual-rule pattern (path-scoped on MR, full suite on main/release)
  • Triggers on: deploy/**/*, docs/**/*, CLAUDE.md, .gitlab-ci.yml

docs/development-guide.md — CI documentation updates

  • Stage table: adds docs:validate to lint stage
  • Path-Based Trigger Mapping: adds deploy/docs/CLAUDE.md row
  • MR Blocking section: documents docs-only MR behavior
  • Local checks: adds ansible-playbook and yamllint commands

Note

This MR should be merged FIRST before docs-only MRs (like !154 (merged)) can pass pipeline.

Merge request reports