Documentation "9.3.7. Agents" has a number of poorly explained parameters

[ahawkes]

Describe the bug

A clear and concise description of what the bug is, including error messages.

Confusing descriptions reported by users for several parameters here:

AgentShare Name of the share of the existing capacity assigned to this agent. Only meaningful for retrofit agents. The actual share itself can be found in Techno-data.

Quantity A factor used to determine the demand share of “New” agents.

MaturityThreshold Parameter for the search rule maturity.

SpendLimit Parameter for the search rule spend_limit.

To Reproduce

Steps to reproduce the behavior. Attache any input file that might be required.

Expected behavior

A clear and concise description of what you expected to happen.

Changes needed: AgentShare - explain why this is needed and how it is used with an example Quantity - explain why this is needed and how it is used with an example MaturityThreshold - explain why this is needed and how it is used with an example SpendLimit - explain why this is needed and how it is used with an example

Screenshots

If applicable, add screenshots to help explain your problem.

Context

Please, complete the following to better understand the system you are using to run MUSE.

• Operative system (eg. Windows 10):
• MUSE version (eg. 1.0.1):
• Installation method (eg. pipx, pip, development mode):
• Python version (you can get this running python --version):