Updated API Blueprint Documentation (markdown)
Add some explanation to versions and defining arrays in a response.