mostly cosmetic, adding some type hints, and clarifying comments#16

amirziai wants to merge 2 commits intosnap-stanford:mastersnap-stanford/deepsnap:masterfrom

amirziai:masteramirziai/deepsnap:masterCopy head branch name to clipboard