add some comments
do not abort whole update if one download fails; fix some whitespace in logging; add comments and TODOs