docs(button): Fix #573 add stronger docs for submit and cancel buttons

See conversations at https://jira.rax.io/browse/EOD-187 ("Call to action/button design treatment")
And we *tend* to use "Encore-UI", instead of "EncoreUI", but this is something that needs a consistency check at some point