Clarify fields, improve examples, and make the tables in the spec be generated rather than duplicated.
Reduces data duplication and makes the objects more reusable for other areas of the spec