API v1 spec

rewrite of the spec in .MD format to better support clean code blocks.

moved into approved folder

Change-Id: Ida36a618cfeb5a5097cd88bbb09e6b15c8f8f9a1
storyboard: https://storyboard.openstack.org/#!/story/132