Make optimizer docstrings consistent

[isaacdevlugt]

Context: Came up in discussing #7606

Description of the Change: Reorders the docstrings of each optimizer: (1) brief description of optimizer (2) theory if needed (3) Parameters (4) examples if needed.

Benefits: consistency

Possible Drawbacks: 🤷

Related GitHub Issues:

[github-actions]

Hello. You may have forgotten to update the changelog!
Please edit doc/releases/changelog-dev.md with:

• A one-to-two sentence description of the change. You may include a small working example for new features.
• A link back to this PR.
• Your name (or GitHub username) in the contributors section.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.68%. Comparing base (bb029e1) to head (afcb3ad).
⚠️ Report is 414 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #7891   +/-   ##
=======================================
  Coverage   99.68%   99.68%           
=======================================
  Files         544      544           
  Lines       55413    55413           
=======================================
  Hits        55236    55236           
  Misses        177      177           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

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

[SimoneGasperini]

Looks good, thanks!

The only comment I have is that we might still be missing some default values for the parameters. Also, I noticed that sometimes we do e.g. stepsize=0.1 (float): ... while in other cases we do stepsize (float): ... (default: 0.1).

Don't know if it's worth to fix but it would be nice for consistency :)

[isaacdevlugt]

@SimoneGasperini good catch! I updated the docstrings with your recommendation :)

[AntonNI8]

Thanks @isaacdevlugt!