implement @ckarlof's API and README.md suggestions

* use "computeX" instead of "getX"
* Rename (external) "a"/"b" to "secret1"/"secret2" to avoid footguns.
* add an API summary
* comment out the unimplemented "checkM2" method