Dead link checker

[PiotrKorkus]

📌 Description

Add bazel target with sphinx builder checking external links. This solves an issue when dead links are referenced.

🚨 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: 50fd479d-c221-46cb-8345-921aad52aade
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Loading: 
Loading: 0 packages loaded
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 (72 packages loaded, 9 targets configured)

Analyzing: target //src:license-check (123 packages loaded, 1910 targets configured)

Analyzing: target //src:license-check (134 packages loaded, 2484 targets configured)

Analyzing: target //src:license-check (136 packages loaded, 2489 targets configured)

INFO: Analyzed target //src:license-check (137 packages loaded, 4500 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: 12.594s, Critical Path: 0.44s
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 <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>]

[PiotrKorkus]

Removed outdated "Structure of the extension's logic" section from contributing documentation, deferring to AGENTS.md instead
useblocks/sphinx-needs#1621

[github-actions]

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

[AlexanderLanin]

• This should be part of docs_check or even normal build?
• Isn't there some sphinx extension that can already do that? -> ah, its a builder. Thats quite unfortunate.

[AlexanderLanin]

docs_check does not have a builder (not an intentional one). We can change docs_check to use the linkcheck builder?!

[MaximilianSoerenPollak]

docs_check does not have a builder (not an intentional one). We can change docs_check to use the linkcheck builder?!

Might make the most sense I would say? Since many people use that workflow anyway?
Though the other improvements / changes are still good to have.

[PiotrKorkus]

Process description links fixed in eclipse-score/process_description#538
Should be passing now

[AlexanderLanin]

Merging main. Hopefully this will result in proper error message of consumer tests.

[MaximilianSoerenPollak]

Merging main. Hopefully this will result in proper error message of consumer tests.

~~I think it's stuck. ~~
https://github.com/eclipse-score/docs-as-code/actions/runs/21401719523/job/61614344220?pr=367

Holy 30min.. I think we need to speed this up :D