clarification and more error logging