Comment by tiborsaas
5 days ago
It's exactly that, but I don't see the issue. API+Docs under a single URL looks like a win for me. It also warrants a new name.
5 days ago
It's exactly that, but I don't see the issue. API+Docs under a single URL looks like a win for me. It also warrants a new name.
> new name
Swagger was the new old name for the concept
Exactly! Swagger descriptions+GUI[1], HATEOAS[2], and JSONAPI[3] all coming together in jubilous harmony if MCP pulled its head out of the sand, but instead we get the XKCD#927[4] situation.
1: https://swagger.io/docs/specification/v3_0/adding-examples/
2: https://en.wikipedia.org/wiki/HATEOAS
3: https://jsonapi.org
4: https://xkcd.com/927/