updated docs, clarified error