more docs
fail more graciously