CAMARA Tooling documentation

This documentation helps CAMARA API contributors, codeowners, and release coordinators use shared tooling in API repositories.

CAMARA Validation

CAMARA Validation checks API definitions, test files, and release planning files in CAMARA API repositories. Results appear on pull requests and on Release Issues, so contributors and codeowners can see what needs to change before code reaches a release.

Working on a pull request

• Find the validation results
• Fix validation problems on a pull request
• Understand error, warning, and hint messages
• Understand what a result obligates your team to do
• Read guidance for common validation problems

Preparing a release

• Fix a failed /create-snapshot run
• Understand validation on a Release PR
• Preview the bundled API definition

Checking manually

• Run validation manually

Release Automation

Release Automation drives the CAMARA release process from /create-snapshot to /publish-release. The user-facing documentation lives in the ReleaseManagement repository.

It also supports synchronization of cached code/common/ files used by validation and API definitions. See the CAMARA Validation FAQ entry for [P-021] when a validation result reports that code/common/ is missing or out of sync.

Future tooling area

Reserved for later user-facing documentation about other shared tooling in CAMARA API repositories.