Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

New API Format Roll Out post origin

  • Loading branch information...
commit 55ddc8dd2e351afd34a7c9598c8498cb55703dc4 1 parent 0a52c6f
Z zdne authored
Showing with 27 additions and 0 deletions.
  1. +27 −0 _posts/
27 _posts/
@@ -0,0 +1,27 @@
+title: Blueprint Format Roll Out
+excerpt: New API Blueprint Format specification has been closed as we are getting ready for its roll out.
+layout: post
+date: 2013-03-12 09:00:00 +1000
+author: zdenek
+published: NO
+As you may know the [New API Blueprint Format]( will be rolling out soon and today I would like to discuss how it will be done.
+## 1A Format Specification
+First I would like to thank to our awesome users who did contribute to the New Format in reaction to my previous [post]( In the process we have made quite few changes to the Format and you can find its [final specification]( in our (open sourced) [parser repository]( The specification is also accompanied by few [examples]( if you want to get a quick peek on how it will look like.
+Note that this first version is only a mere milestone on the [Format evolution]( However we still keep the main thing the main thing: The **API Blueprint must be the best way possible for both designing and documenting your API**.
+## Roll Out
+The rollout will be on opt-in basis. That is we won't "switch" everything to new format immediately. Instead the two (legacy and 1A) formats will live in parallel for some time. You will be able to opt-in for the New Format by specifying format version in your blueprint's [metadata](
+Also there will be automatic lossless transition from the legacy format to the New Format possible. No need to rewrite anything by hand.
+With that being said if you are familiar with the current format or do not mind to quickly dive in it is perfectly fine to start with your API today without any fear that you will have to start over once the New Format arrives.
+As always I would love to hear from you. You can reach me on [my email]( or comment on [New API Blueprint Format](
Please sign in to comment.
Something went wrong with that request. Please try again.