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.
Instead of going down the rabbit hole here, maybe just add a pointer to the message description somewhere else, like in the docs in this same repo.