Inline Documentation
The Grey Matter Application has built-in support for rendering inline OpenAPI documentation v2 - v3. Services configured with an inline documentation specification will render an "API Documentation" tab across historical and instance views.
Service with inline OpenAPI Specification rendering

Enable inline documentation

To enable inline documentation rendering, the Grey Matter Application must be deployed with the ENABLE_INLINE_DOCS environment variable set to true. This will activate the "API Documentation" tab within the UI.
To configure the endpoint where API specifications will be pulled, update the service's api_spec_endpoint field on its catalog-service object using the greymatter CLI. This field can either be a relative path or a fully qualified URL.
1
greymatter edit catalog-service example_service
Copied!
In the open editor window, set the api_spec_endpoint to a relative path like the example below.
1
{
2
"service_id": "example-service",
3
"mesh_id": "default-zone",
4
"name": "Example Service",
5
"version": "1.0",
6
"owner": "Decipher",
7
"capability": "Example",
8
"api_spec_endpoint": "/services/example-service/docs"
9
}
Copied!
Last modified 7mo ago
Export as PDF
Copy link