Use Quarto / Quartodoc for documentation

[ecomodeller]

• ➕ Notebooks are rendered nicely
• ❓ quartodoc is different from mkdocsstrings
• ➕ Executable docstring examples, including figures and tables as output

[ecomodeller]

To avoid explicitly specifying all members explicitly on aliases we need this PR machow/quartodoc#327

We prefer PointModelResult instead of model.point.PointModelResult (the location in file system should be irrelevant to the user).

[ecomodeller]

@jsmariegaard 💾Rendered html

[jsmariegaard]

Thanks for all the hard work converting our docs to quartodoc!

Earlier this year, I worked quite a lot on the API documentation - including "header" information on most of the subpages - see e.g. https://dhi.github.io/modelskill/api/comparer/ or https://dhi.github.io/modelskill/api/model/ which has general information about the structure with links to important methods etc. These pages are now gone - I think that is a pity - not just because I spend time writing them but also because I found that useful.

• Could you please re-introduce the overview pages in the API docs - especially for ModelResult, Observation, Matching, Comparer?
• Could you please remove the API sub-headings (in the left hand side nav bar) for Plotting, Metrics, Quantity and Settings - it is annoying that you need to expand a subsection with only one element.
• Change headline of API reference to "API reference" instead of "Function reference"
• I would suggest to remove the plot on the frontpage of the documentation as I think it is more clean and nice without - but I am flexible here :-)

[ecomodeller]

• Could you please re-introduce the overview pages in the API docs - especially for ModelResult, Observation, Matching, Comparer? ⌛
• Could you please remove the API sub-headings (in the left hand side nav bar) for Plotting, Metrics, Quantity and Settings - it is annoying that you need to expand a subsection with only one element. ✔️

Using class docstring:

• Change headline of API reference to "API reference" instead of "Function reference"
  Using a custom index page based on the existing mkdocs version.