adding detailed description of return values