Fix register nym docs

The cost of documentation becomes clear immediately in 9272fad.

Other than that I'm wondering how far I should go explaining the returned message.
Agree on using `result` when we're doing a quick, local API call and `response` for network activity? Rename in a separate commit.