Improve documentation of algorithm options

[janosg]

[codecov[bot]]

Codecov Report

:white_check_mark: All modified and coverable lines are covered by tests.

Files with missing lines	Coverage Δ
src/optimagic/optimizers/_pounders/bntr.py	86.71% <ø> (ø)
...timagic/optimizers/_pounders/pounders_auxiliary.py	97.32% <ø> (ø)
src/optimagic/optimizers/pounders.py	92.56% <ø> (ø)
src/optimagic/optimizers/scipy_optimizers.py	96.96% <100.00%> (+0.05%)	:arrow_up:
src/optimagic/typing.py	88.50% <100.00%> (+1.66%)	:arrow_up:

:rocket: New features to boost your workflow:

• :snowflake: Test Analytics: Detect flaky tests, report on failures, and find test suite problems.