add input/output information in doc strings
address review feedback