> This is different from swagger / OpenAPI how? Because the descriptions aren't API specs and the things described aren't APIs. Its more like a structure for

> This is different from swagger / OpenAPI how? Because the descriptions aren't API specs and the things described aren't APIs. Its more like a structure for human-readable descriptions in an annotated table of contents for a recipe book than it is like OpenAPI.