clarified README; added more informative logging