document structure rearranged
description corrected
Merge branch 'dev' of https://github.com/isaacloud/api.raml into dev