schema-to-pojo should have a property indicating deprecation instead of relying on the "description" field to communicate this

The generated code would then be able to place a @Deprecated annotation on the getters and setters so it is readily apparent in the IDE that a field has been deprecated.

lib-javadoc would then also have enough context info to either hide the field, or display it differently (light-gray text?) in the REST API docs.