add docs to some TODOs