update deps
add more descriptive comments; formatting fixes