Remove the WHY section. No one cares. Keep things as if you were writing a TLDR.. Don't use jargon or your own naming convention for things. "Dumb english" is best. Show an example as soon as possible. Then explain what the kinds do, and the fields in them.