move bunch of docs to README, return exceptionalException.emailErrors for informative purposes