docs: Add arguments explanation to functions docs

[mmarchini]

There was only a textual explanation for the functions. Having all parameters listed helps a quicker look at those functions, and reading the explanation is only needed the first time (or if trying to better understand the API).