[cdap-597] updates for the documentation