Skip to content

Add externalDocs repository/description checks (P-038, P-039) - #410

Merged
hdamker merged 1 commit into
camaraproject:mainfrom
hdamker:feat/p038-p039-externaldocs-checks
Aug 7, 2026
Merged

Add externalDocs repository/description checks (P-038, P-039)#410
hdamker merged 1 commit into
camaraproject:mainfrom
hdamker:feat/p038-p039-externaldocs-checks

Conversation

@hdamker

@hdamker hdamker commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

What type of PR is this?

enhancement/feature
tests

What this PR does / why we need it:

Adds two validation checks for the externalDocs object (Design Guide §5.4): P-038 warns on a missing or wrong externalDocs.url; P-039 hints when description doesn't match the required text. Both compare against camaraproject, so a fork run gives the same result as upstream.

Checked against all current CAMARA API definitions: 14 P-038 and 38 P-039 findings, all pre-existing.

Which issue(s) this PR fixes:

Fixes #409

Special notes for reviewers:

Local checks run:

  • python3 -m pytest validation/tests/test_python_checks_externaldocs.py -q
  • python3 -m pytest validation/tests/test_rule_metadata_integrity.py -q
  • python3 -m pytest validation/tests -q (1228 passed; 3 pre-existing failures in test_yaml_parser_conformance.py, unrelated to this change)

Changelog input

release-note
Adds externalDocs.url (P-038, warn) and externalDocs.description (P-039, hint) checks against the Design Guide §5.4 template.

Additional documentation

This section can be blank.

docs

@hdamker
hdamker requested review from Kevsy and rartych as code owners August 6, 2026 06:08
@hdamker hdamker added this to the v0.9.0 milestone Aug 6, 2026

@Kevsy Kevsy left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@hdamker
hdamker merged commit d4f1a31 into camaraproject:main Aug 7, 2026
8 checks passed
@hdamker
hdamker deleted the feat/p038-p039-externaldocs-checks branch August 7, 2026 08:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Validate externalDocs.url and description against Design Guide §5.4

2 participants