DOC: added missing documentation details (Parameters and return values)