BATCHEE-30 add proper JavaDocs