Comparison with OpenAPI (fka Swagger)

The OMG and OpenAPI have very similar goals, but focus on two different aspects.

The table below highlights the key differences between OpenAPI and the OMG:

OpenAPI Open Microservice Guide
Focuses on defining and documenting REST APIs for a particular service Focuses on defining and documenting the deployment of a service, right from its lifecycle, to the APIs exposed
Built for HTTP only Completely agnostic of the underlying data exchange protocol
APIs are expressed as HTTP paths APIs are expressed as actions - an action can be executed via a HTTP request, or a shell command within that service

The OMG is heavily inspired by the OpenAPI 3.0 specification, and as such, it borrows a lot of the existing schema from OpenAPI.