Clean up JSON documentation syntax

This presents a much clearer and more comprehensible syntax for documenting
API objects. Each field's type is explicitly declared, and the meanings are
listed separately below.