touch readme + more javadocs