document params and return value