docs; notes to self about error handling