DEV Community

Discussion on: Towards a JavaScript API Specification

orkon profile image
Alex Rudenko

What do you think of ?

miralemd profile image
Miralem Drek Author

For REST APIs, it's seems usable for smaller projects. Using JSX over plain JavaScript will most likely introduce some limitations in what is possible.

Regarding the output, keep in mind that API Blueprint is about documenting the API and is not meant to be a description that can be easily consumed by other tools. OpenAPI on the other hand focuses on the description, which you can then use to generate a blueprint document.