more bugs

I actually decided to test this end-to-end :grinning: - I found one more minor issue in an error handling case and fixed up a few formatting issues I noticed in the docs.  I added the example client I used to exercise all IDENTIFY options. cc @jehiah