Bad: if you do not document your schemas, users have two other options — they can rifle through your source code or refer to a separate document.
Harder words are more like items at the bottom of a box-we must rifle through the items we use more often to reach the buried rarity.