You might find this project interesting: <a href="http:&#x2F;&#x2F;swagger.io" rel="nofollow">http:&#x2F;&#x2F;swagger.io</a><p>We use it to document services by reflecting docs off of the implemented service. Upside, no drift!