Skip to content

๐Ÿ“ Action: PR Hygiene Validator

Ensure absolute consistency across repository commit history and Pull Request descriptions.


[!IMPORTANT] A clean git history is critical for automated release notes and overall repository health. The PR Hygiene Validator enforces Conventional Commits formatting for Pull Request titles and ensures that all PR bodies meet a minimum character length.

๐Ÿš€ Key Impact

  • ๐Ÿšฅ History Integrity: Guaranteed Conventional Commits for better automated changelogs.
  • ๐Ÿ’ฌ Quality Descriptions: Prevents empty PR bodies by enforcing minimum length thresholds.
  • ๐Ÿค– Automated Policing: Posts corrective feedback directly to the PR for engineer self-service.

โš™๏ธ Configuration

Input Required Default Description
github-token Yes - Token for API interactions and comments.
min-description-length No 15 Minimum character count for the PR body.

โšก Quick Start

- name: ๐Ÿ“ Validate PR Hygiene
  uses: carlos-camara/qa-hub-actions/pr-hygiene-validator@main
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}
    min-description-length: '30'

[View Full Wiki](https://carlos-camara.github.io/qa-hub-actions/actions/pr-hygiene-validator/)