Autogenerate api docs

[je-cook]

Description

Closes #3834
Closes #1532
Closes #3844
possibly also #2936

This

• Adds auto api docs generation
• removes most of the vardes stuff
• converts all the docstrings to use the numpy docstring style because autoformatting of sphinx api docs is on the whole no supported by mkdocs (many features are missing).

Most of the docs changes were done automatically by the pyment package with some manual fixes afterwards.

This adds a few docs dependencies too.

Sorry its so long...

Checklist

I confirm that I have completed the following checks:

• My changes follow the PROCESS style guide
• I have justified any large differences in the regression tests caused by this pull request in the comments.
• I have added new tests where appropriate for the changes I have made.
• If I have had to change any existing unit or integration tests, I have justified this change in the pull request comments.
• If I have made documentation changes, I have checked they render correctly.
• I have added documentation for my change, if appropriate.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 88.37209% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 46.83%. Comparing base (c150e7d) to head (418fe2a).

Files with missing lines	Patch %	Lines
process/io/plot_proc.py	66.66%	7 Missing ⚠️
process/io/costs_bar.py	0.00%	1 Missing ⚠️
process/io/data_structure_dicts.py	50.00%	1 Missing ⚠️
process/io/process_config.py	94.11%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4097      +/-   ##
==========================================
+ Coverage   46.67%   46.83%   +0.16%     
==========================================
  Files         136      136              
  Lines       29207    29297      +90     
==========================================
+ Hits        13633    13722      +89     
- Misses      15574    15575       +1     

☔ 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.

[timothy-nunn]

Couple of concerns before I continue reviewing. The auto converter seems to be not getting the formatting quite correct

[timothy-nunn]

A couple of comments from this batch of the review... 248/312 viewed 😆

We should probably make some issues/papercuts about enabling ruff rules for docstrings now that they will be in a somewhat sensible format.

A lot of the docstrings are empty... this could also be a recurring papercut where each sprint someone checks the docstrings of say 5 files

[timothy-nunn]

We need to make an issue to fill these empty parameter sections in... sounds papercutty

[timothy-nunn]

I haven't raised every single instance of :references:, some more will exist.

Some weird misalignments too.

That all the files currently checked.