api: explains parameters and arguments