Repository to describe and document common guidelines and assets for CAMARA APIs
- Guidelines and assets for “Commonalities” (see APIBacklog.md)
- All deliverables are mandatory for all CAMARA Sub Projects
- Describe, develop, document and test the deliverables
- Started: October 2021
- Location: virtually
The documents that are relevant for CAMARA API Sub Projects are found in the documentation directory (at the top-level). The rest of the sub-directories are primarily for internal working of the Commonalities Working Group.
The artifacts directory contains:
- templates for creating Github issues
- common data and error formats for CAMARA APIs in CAMARA_common.yaml
- notification subscription template: event-subscription-template.yaml
- OAS definition of CAMARA Event using CloudEvents: notification-as-cloud-event.yaml
A list of some of the frequently accessed documents that are an output of the work done in the Commonalities Working Group is provided below. Note that the links are relative to the branch selected. Refer to the section below for released versions.
| Document name | Purpose |
|---|---|
| API-design-guidelines.md | This document captures guidelines for the API design in CAMARA project. These guidelines are applicable to every API to be worked out under the CAMARA initiative. |
| Glossary.md | A glossary of the common terms and their API parameter/field names for use in the APIs |
| API-Testing-Guidelines.md | Guidelines for the API testing in CAMARA project |
NOTE: Guidelines for Release Management of API versions, e.g. the API-Readiness-Checklist, are located within ReleaseManagement. The versioning of APIs is defined within the API-design-guidelines.md.
- Alpha release of version 0.5.0 of guidelines and assets for CAMARA APIs is available with the r2.1 tag
- Release 0.4.0 of guidelines and assets for CAMARA APIs is available with the r0.4.0 tag
- Previous releases and pre-releases are available in https://github.com/camaraproject/Commonalities/releases
For changes see CHANGELOG.md
- Meetings are held virtually on the LF Platform: Meeting Registration / Join
- Schedule: bi-weekly, Monday, 4 PM CET/CEST (3 PM BST, 15:00 UTC). The date of the next meeting can be found in the previous meeting minutes.
- To subscribe / unsubscribe to the mailing list of this Sub Project and thus be / resign as Contributor please visit https://lists.camaraproject.org/g/wg-commonalities.
- A message to all Contributors of this Sub Project can be sent using [email protected].