clearer warnings for when things go wrong