feat: add documentation, fix: confusing language, add email subject in error message

[edcous]

Tested on my machine and it works, so we can go ahead and merge/deploy if you're OK with it?