Update doc creation, Fix content

[vvmruder]

• rebase on underlying libs
• fix sphinx
• fix autodoc
• fixes Clean Readme and Doc #1257
• fixes Use makefile2graph to visualze Makefile target dependencies #1240
• fixes Documentation: fix warnings #1675

[codecov]

Codecov Report

Merging #1854 (9d5b3e0) into master (348b15c) will not change coverage.
Report is 1 commits behind head on master.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #1854   +/-   ##
=======================================
  Coverage   77.73%   77.73%           
=======================================
  Files         127      127           
  Lines        5268     5268           
=======================================
  Hits         4095     4095           
  Misses       1173     1173           

Flag	Coverage Δ
unittests	77.73% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files	Coverage Δ
...b/contrib/data_sources/standard/models/__init__.py	100.00% <ø> (ø)
...oereb/contrib/data_sources/standard/models/main.py	100.00% <ø> (ø)
...contrib/print_proxy/mapfish_print/mapfish_print.py	86.14% <ø> (ø)
pyramid_oereb/core/readers/data_integration.py	0.00% <ø> (ø)
pyramid_oereb/core/readers/law_status.py	100.00% <ø> (ø)
pyramid_oereb/core/readers/real_estate_type.py	100.00% <ø> (ø)
pyramid_oereb/core/records/view_service.py	82.90% <ø> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[vvmruder]

@voisardf & @michmuel & @julianhafner:

The DOC refactoring is done. Please feel free to test and comment.

You can do the doc build with:

docker compose run --rm oereb-server make doc-html

Files are created here (open it in browser should work unless some security settings are blocking it):

doc/build/html/index.html

This PR is purely structure refactoring and preparation of further doc work. The doc structure now reflects the more modular python contrib approach of pyramid_oereb.

One PR which will be rebased and merged ontop of this one is #1466

[julianhafner]

Looks good to me so far 👍 The structure refactoring is good for further doc work.
To me some of the newly added makefile2graph graphs are more confusing than helpful, but that might be personal preference.

[voisardf]

Looks good to me, thanks.

Just one question regarding some of the files like

• doc/source/contrib/data_sources/standard/index.rst.mako and
• doc/source/contrib/data_sources/standard/index.rst

is there a reason for keeping both, the index.rst.mako and the index.rst which should normally be generated based on the mako file? What did I miss there?

[vvmruder]

Looks good to me, thanks.

Just one question regarding some of the files like

* doc/source/contrib/data_sources/standard/index.rst.mako and

* doc/source/contrib/data_sources/standard/index.rst

is there a reason for keeping both, the index.rst.mako and the index.rst which should normally be generated based on the mako file? What did I miss there?

😬 Good catch 😆

I removed it.