Doc: pypesto.select xrefs + add select.postprocessors

[dweindl]

Fixes formatting, adds proper cross-references, and add pypesto.select.postprocessors to the sphinx API doc.

👀 https://pypesto--1146.org.readthedocs.build/en/1146/api/pypesto.select.postprocessors.html

[codecov-commenter]

Codecov Report

Merging #1146 (de8960f) into develop (160c2a8) will decrease coverage by 3.80%.
Report is 399 commits behind head on develop.
The diff coverage is 87.95%.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

@@             Coverage Diff             @@
##           develop    #1146      +/-   ##
===========================================
- Coverage    88.16%   84.37%   -3.80%     
===========================================
  Files           79      148      +69     
  Lines         5257    11645    +6388     
===========================================
+ Hits          4635     9825    +5190     
- Misses         622     1820    +1198     

Files	Coverage Δ
pypesto/C.py	100.00% <100.00%> (ø)
pypesto/__init__.py	100.00% <100.00%> (ø)
pypesto/engine/__init__.py	100.00% <100.00%> (ø)
pypesto/engine/multi_process.py	93.10% <100.00%> (+0.79%)	⬆️
pypesto/engine/multi_thread.py	100.00% <100.00%> (ø)
pypesto/engine/single_core.py	100.00% <100.00%> (ø)
pypesto/engine/task.py	100.00% <100.00%> (ø)
pypesto/ensemble/__init__.py	100.00% <100.00%> (ø)
pypesto/ensemble/task.py	100.00% <100.00%> (ø)
pypesto/hierarchical/__init__.py	100.00% <100.00%> (ø)
... and 138 more

[PaulJonasJost]

Thanks for this, do you think we need to do this at one point for other modules as well?

[dilpath]

Thanks a lot! For some reason pathlib.Path is documented as pypesto.select.postprocessors.Path on RTD. I still need to go over the docs and fill in missing docstrings etc., so this can be left to another PR.

https://pypesto--1146.org.readthedocs.build/en/1146/api/pypesto.select.postprocessors.html#pypesto.select.postprocessors.Path

[dweindl]

do you think we need to do this at one point for other modules as well?

At some point, yes. Not a priority.

For some reason pathlib.Path is documented as pypesto.select.postprocessors.Path

Resolved.