updated docs, cleaned up validation errors