API Blueprint is much, much cleaner: https://apiblueprint.org https://apiblueprint.org Here's a renderer: https://github.com/danielgtaylor/aglio https://github

API Blueprint is much, much cleaner: https://apiblueprint.org https://apiblueprint.org Here's a renderer: https://github.com/danielgtaylor/aglio https://github.com/danielgtaylor/aglio It's less feature-rich than Swagger but the format is much less of a nightmare.