From d799e13f90ceaf267eea4327e325f8f535bd8e31 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Leone=20Perdig=C3=A3o?= Date: Fri, 20 Mar 2026 20:42:10 +0100 Subject: [PATCH] docs(overview): auto-generate service definition table from schema Replace the hardcoded service definition table with the extension_schema_fields macro to keep the documentation in sync with the actual service.json schema. The previous table described an outdated nested structure (rest.schema, mcp.endpoint, etc.) that no longer matches the current flat transport-based schema. Fixes #136 --- docs/specification/overview.md | 15 +-------------- 1 file changed, 1 insertion(+), 14 deletions(-) diff --git a/docs/specification/overview.md b/docs/specification/overview.md index 14aea05c..b5ce21ba 100644 --- a/docs/specification/overview.md +++ b/docs/specification/overview.md @@ -115,20 +115,7 @@ standard formats: #### Service Definition -| Field | Type | Required | Description | -| ----------------- | ------ | -------- | ----------------------------------- | -| `version` | string | Yes | Service version (YYYY-MM-DD format) | -| `spec` | string | Yes | URL to service documentation | -| `rest` | object | No | REST transport binding | -| `rest.schema` | string | Yes | URL to OpenAPI spec (JSON) | -| `rest.endpoint` | string | Yes | Business's REST endpoint | -| `mcp` | object | No | MCP transport binding | -| `mcp.schema` | string | Yes | URL to OpenRPC spec (JSON) | -| `mcp.endpoint` | string | Yes | Business's MCP endpoint | -| `a2a` | object | No | A2A transport binding | -| `a2a.endpoint` | string | Yes | Business's A2A Agent Card URL | -| `embedded` | string | No | Embedded transport binding | -| `embedded.schema` | string | Yes | URL to OpenRPC spec (JSON) | +{{ extension_schema_fields('service.json#/$defs/platform_schema', 'overview') }} Transport definitions **MUST** be thin: they declare method names and reference base schemas only. See [Requirements](#requirements) for details.