Spec gen rev1

@remear this pull request adds support for the fields of rev1 coming out of the balanced-api repo.  The types of the fields and the description are defined in the schemas.  To demonstrate if a field is required, then have it present in all the create scenarios.  To show that a field is not required, have a scenario where the field is not present.

The data for the new version comes from running the `rake cruse` command in balanced-api and then it generates a `balanced.rev1.json` file which is copied over into the balanced-docs