Match 'Policy' API documentation to Razor Command Reference

While I was getting up and running with Razor I noticed at least one discrepancy between the documentation provided for Policies on the [Razor Command Reference](http://docs.puppetlabs.com/pe/latest/razor_reference.html#create-policy) and what is in doc/api.md. The information in the razor-server repo appears to be outdated, while the information on docs.puppetlabs.com appears to match the current version of razor-server.

While I have located and fixed this once instance, perhaps the real issue to address is whether there is way to make both of these documentation references come from the same source?