added some java docs and changed params for facades