Client help text is very hard to understand

The help text that 'razor help create-policy' creates is very hard to follow. The main problem is that the help text describes the API rather than the command line usage. This makes it hard for users to understand what they should pass on the command line; in particular, the help for references to other objects is very awkward.