docs: Fix registration of HeaderService

[nicu1989]

Esbonio crashes due to score_header_service extension being registered when trying to build for the second time.

Related: eclipse-score/score#1117

[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 and connecting to it...
INFO: Invocation ID: 5796cc6f-c00e-4b50-9dda-dc619a466dc4
Computing main repo mapping: 
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
    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 (96 packages loaded, 10 targets configured)

Analyzing: target //src:license-check (104 packages loaded, 10 targets configured)

Analyzing: target //src:license-check (148 packages loaded, 1613 targets configured)

Analyzing: target //src:license-check (153 packages loaded, 2652 targets configured)

Analyzing: target //src:license-check (158 packages loaded, 2687 targets configured)

Analyzing: target //src:license-check (162 packages loaded, 4820 targets configured)

INFO: Analyzed target //src:license-check (163 packages loaded, 4946 targets configured).
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: 18.496s, Critical Path: 0.35s
INFO: 13 processes: 4 disk cache hit, 9 internal.
INFO: Build completed successfully, 13 total actions
INFO: Running command line: bazel-bin/src/license.check.license_check src/formatted.txt -review -project automotive.score -repo https://github.com/eclipse-score/docs-as-code -token otyhZ4eaRYK1tKLNNF-Y
[main] INFO Querying Eclipse Foundation for license data for 83 items.
[main] INFO Found 58 items.
[main] INFO Querying ClearlyDefined for license data for 25 items.
[main] ERROR Error response from ClearlyDefined 429

[nicu1989]

The error that Esbonio throws when building for the 2nd time that this PR is fixing:

ERROR: sphinx-build failed
Traceback (most recent call last):
  File "/home/nicu/.cursor/extensions/swyddfa.esbonio-0.96.4-universal/bundled/libs/esbonio/sphinx_agent/handlers/__init__.py", line 169, in build_sphinx_app
    self.app.build()
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/application.py", line 426, in build
    self.builder.build_update()
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/builders/__init__.py", line 375, in build_update
    self.build(
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/builders/__init__.py", line 403, in build
    updated_docnames = set(self.read())
                           ^^^^^^^^^^^
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/builders/__init__.py", line 508, in read
    self.events.emit('env-before-read-docs', self.env, docnames)
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/events.py", line 404, in emit
    results.append(listener.handler(self.app, *args))
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/nicu/.cache/bazel/_bazel_nicu/a0d5ff9caf04d47e61bd0eb1316606a8/execroot/_main/bazel-out/k8-fastbuild/bin/docs/ide_support.runfiles/score_docs_as_code~/src/extensions/score_header_service/header_service.py", line 59, in register
    app.add_config_value("header_service_use_github_data", True, "env")
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/application.py", line 940, in add_config_value
    self.config.add(
  File "/mnt/d/qorix/forks/score/.venv_docs/lib/python3.12/site-packages/sphinx/config.py", line 524, in add
    raise ExtensionError(__('Config value %r already present') % name)
sphinx.errors.ExtensionError: Config value 'header_service_use_github_data' already present

[github-actions]

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

[AlexanderLanin]

Thanks for that analysis!

If this PR doesn't work, just disable header service completely! We don't use it at the moment, or anytime soon.