#143 applied java-api cleanup and documentation