News Filtered by : Apiary.io

New API Blueprint Format – Feedback for apiary.io

support.apiary.io on 02/17/2013

Excerpt: We still want to keep (and even improve) the simplicity and readability of the format. Here are some of the intended advantages: The first motivation is to make the documentation more text/prose/use-case focused and less URL/method focused. The second motivation is to better fit into existing ecosystems (all Markdown syntax highlighters would do a good job of highlighting the blueprint). Third - we feel we'll have more room to grow our feature-set (multiple responses per resource, defined parameters / authentication style etc. ) If this transition ever happens, we will warn all users upfront, give them time to prepare, migrate all their existing blueprints automatically and offer assistance with any migration issues.... read the full post.
Tags: API-Evangelist, API-Stack, Apiary.io