Thanks for the feedback, I just opened a PR to add a link from the spec readme to our website to hopefully guide people to better information.
I just want to see what I'm getting into, not a vocabulary or jargon lesson, at least at first.
That would lead us to then wonder why it was done that way, etc... and drive interest.