Parameter descriptions needs improvement

[mosoriob]

🚀 Feature Request

Parameter descriptions needs improvement

🔈 Motivation

@mepearson asked about the parameters. If someone asks, the parameter descriptions are not good enough.

🛰 Alternatives

• Improve parameters name and description
• Add notice for new users

📎 Additional context

Diagram internal

[mosoriob]

My proposal

[wmobley]

We should look at which actually need to be variables and which we can make constants. That should help a bit.