updated JavaDocs and added docker/vagrant for testing