authentication: some error handling
readme: clean up first example