Sphinx gha

[lisajulia]

Based on #5243, which should be merged first.
Furthermore includes:

• Add documentation for the Python bindings from opm-common
• Add documentation for opm_embedded

[lisajulia]

jenkins buil this opm-common=4018 please

[lisajulia]

I'm currently still working on these two issues:

• The way of making the docstrings_common.json from opm-common available here is not ideal yet, since this file is copied around a lot:
  https://github.com/OPM/opm-common/pull/4018/files#diff-1e7de1ae2d059d21e1dd75d5812d5a34b0222cef273b7c3a2af62eb747f9d20aR477
  https://github.com/OPM/opm-simulators/pull/5349/files#diff-3764531759f1b50aee06cf2267f2ab7508c016a86d776664e4754694fd711bf9R24

• I'm still working on the documentation structure, since now all methods of all classes from opm-common are listed under "common" but actually they should be grouped

[lisajulia]

I'm currently still working on these two issues:

* The way of making the docstrings_common.json from opm-common available here is not ideal yet, since this file is copied around a lot:
  https://github.com/OPM/opm-common/pull/4018/files#diff-1e7de1ae2d059d21e1dd75d5812d5a34b0222cef273b7c3a2af62eb747f9d20aR477
  https://github.com/OPM/opm-simulators/pull/5349/files#diff-3764531759f1b50aee06cf2267f2ab7508c016a86d776664e4754694fd711bf9R24

* I'm still working on the documentation structure, since now all methods of all classes from opm-common are listed under "common" but actually they should be grouped

For the first issue:

• I've added a github action in opm-common (https://github.com/OPM/opm-common/pull/4018/files#diff-3ef24fe0222521a806b534108bf828ff317f06b784dd258bb28b0f5c8f1aa722R8) that pushes the current version of docstrings_common.json from opm-common to simulators, also not ideal.
• So at the moment, there are two mechanisms active for taking care of the docstrings_common.json (one withe cmake and one with the github action)
• Overall I'd like to disucss this some more

For the second issue: The methods are grouped now, but there is still room for improvement

[lisajulia]

Almost done, now I still need to change the Poetry build scripts to take the docstrings_common.json from here and not trigger a commit in opm-simulators.

Current state:
A workflow here is triggered when docstrings_common.json is changed in opm-common, the docstrings_common.json then gets updated here and the documentation is rebuilt.

[lisajulia]

jenkins build this please

[lisajulia]

jenkins build this opm-common=4018 please

[lisajulia]

jenkins build this opm-common=4018 please

[lisajulia]

@hakonhagland and @blattms this is also ready for review, finally!

[hakonhagland]

This looks good to me. Great that you managed to use GitHub actions in opm-common to trigger the sphinx build workflow in opm-simulators, hope this can be activated and tested in practice soon 😄

[hakonhagland]

hope this can be activated and tested in practice soon

@atgeirr Can you have a look at #5243 (which is a prerequisite for this PR)

[lisajulia]

jenkins build this please

[lisajulia]

For the build here to go through, github actions need read and write permissions:
Can someone check how the permissions are set currently?