Improve time series settings documentation

[dbrakenhoff]

Short Description

Improve documentation of time series settings and add type checking to settings dictionary.

Your IDE can also autocomplete the settings dictionary:

Checklist before PR can be merged:

• closes issue [ENHANCEMENT] improve documentation of settings in StressModels #574, [ENHANCEMENT] more informative error when no setting is provided #537
• is documented
• Format code with Black formatting
• type hints for functions and methods
• tests added / passed

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
✅ +0.03% (target: +0.00%)	100.00%

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (ac3da98)	5138	3718	72.36%
Head commit (4cdd191)	5161 (+23)	3736 (+18)	72.39% (+0.03%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#639)	15	15	100.00%

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

[raoulcollenteur]

Looks good to me, very cool! Not sure if the change in utils.py should be part of this PR already? Otherwise ready to merge I think?

Raoul