OLMIS-2292: Document user endpoints
* Added missing schemas
* Improved a few descriptions
* In order for tests to pass, I had to populate some of the domain
returned with jackson annotation to not include non null values in order
to avoid RAML violations
* I made the ID not required for the program schema - we can create new
programs without it.
* User email is not required.