remove TODOs, update JavaDocs