some javadoc/TODOs