API documentation

I ported the information of my blog post http://www.zimuel.it/documenting-apis-using-apigility/ in Markdown and I did new screenshot for the images.