Improve documentation of parameters

Clarify the description and add a more comprehensive example.