[task] adding javadoc
Merge remote-tracking branch 'davidmoebius/BT-21' into BT-21