document the causes of these errors