added new documentation for the parameters