Discussion on: Have you heard of API Blueprint? 📘

eruizdechavez profile image
Erick Ruiz de Chavez

API Blueprints are indeed useful, specially if you are fan of Markdown (I am).

I’ve used the blueprints and Apiary in the past but more recently I decided to leave it behind, mainly because most of the tools are really outdated, unsupported or completely abandoned. Using OpenAPI (formerly Swagger) is now easier with Yaml.

I would probably use the blueprints again for something really small, but for anything that is actual work or a formal documentation I would definitely go with OpenAPI.