Add sphinx_module support

[ramceb]

📌 Description

🚨 Impact Analysis

• This change does not violate any tool requirements and is covered by existing tool requirements
• This change does not violate any design decisions
• Otherwise I have created a ticket for new tool qualification

✅ Checklist

• Added/updated documentation for new or changed features
• Added/updated tests to cover the changes
• Followed project coding standards and guidelines

[github-actions]

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run //src:license-check

Status: ⚠️ Needs Review

Click to expand output

[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.3.0) and connecting to it...
INFO: Invocation ID: a46af36e-ef6e-43c7-9f4a-c75a8e264f56
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Loading: 
Loading: 0 packages loaded
Loading: 0 packages loaded
Loading: 0 packages loaded
    currently loading: src
Loading: 0 packages loaded
    currently loading: src
Analyzing: target //src:license-check (1 packages loaded, 0 targets configured)
Analyzing: target //src:license-check (1 packages loaded, 0 targets configured)

Analyzing: target //src:license-check (57 packages loaded, 9 targets configured)

Analyzing: target //src:license-check (69 packages loaded, 9 targets configured)

Analyzing: target //src:license-check (119 packages loaded, 435 targets configured)

Analyzing: target //src:license-check (129 packages loaded, 1868 targets configured)

Analyzing: target //src:license-check (140 packages loaded, 2576 targets configured)

Analyzing: target //src:license-check (140 packages loaded, 2576 targets configured)

Analyzing: target //src:license-check (144 packages loaded, 3097 targets configured)

INFO: Analyzed target //src:license-check (145 packages loaded, 4715 targets configured).
[12 / 16] JavaToolchainCompileClasses external/rules_java+/toolchains/platformclasspath_classes; 0s disk-cache, processwrapper-sandbox ... (2 actions, 1 running)
[15 / 16] [Prepa] Building src/license.check.license_check.jar ()
INFO: Found 1 target...
Target //src:license.check.license_check up-to-date:
  bazel-bin/src/license.check.license_check
  bazel-bin/src/license.check.license_check.jar
INFO: Elapsed time: 21.759s, Critical Path: 2.48s
INFO: 16 processes: 12 internal, 3 processwrapper-sandbox, 1 worker.
INFO: Build completed successfully, 16 total actions
INFO: Running command line: bazel-bin/src/license.check.license_check src/formatted.txt <args omitted>
usage: org.eclipse.dash.licenses.cli.Main [-batch <int>] [-cd <url>]
       [-confidence <int>] [-ef <url>] [-excludeSources <sources>] [-help] [-lic
       <url>] [-project <shortname>] [-repo <url>] [-review] [-summary <file>]
       [-timeout <seconds>] [-token <token>]

[github-actions]

The created documentation from the pull request is available at: docu-html

[AlexanderLanin]

@ramceb can you use rules_python instead of score_tooling here?

https://rules-python.readthedocs.io/en/latest/api/sphinxdocs/sphinxdocs/sphinx_docs_library.html

[AlexanderLanin]

AFAIK this must be public. I also dont understand the comment in the next line. Looks like a merge problem?

[hoe-jo]

fixed

[MaximilianSoerenPollak]

What is the reason of bringing this in?

Trying to understand why we need/should use this?
Will this be compatible with every consumer / downstream?

[hoe-jo]

It is not breaking anything up to now. So yes it is compatible. And in the process group there was a discussion that we will start a poc for persistency:
https://github.com/orgs/eclipse-score/discussions/407#discussioncomment-15605348

[AlexanderLanin]

To my understanding this is POC development performed by BMW, which we can basically merge as long as it doesn't break the productive docs build. Currently it lacks features in comparison to the current build setup, so it's too early to even discuss which is "better".

We need to be careful to not confuse docs users or management expectations.

[AlexanderLanin]

discussed and agreed to merge