CDAP-811: improve docs