Skip to content

fix: align docs-as-code integration with current setup guide - #385

Draft
umaucher wants to merge 1 commit into
eclipse-score:mainfrom
umaucher:um_docs_as_code_setup_update
Draft

fix: align docs-as-code integration with current setup guide#385
umaucher wants to merge 1 commit into
eclipse-score:mainfrom
umaucher:um_docs_as_code_setup_update

Conversation

@umaucher

@umaucher umaucher commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Sets project/project_url/external_needs directly in the docs() macro call and switches to the needs_json_file targets, per the current docs-as-code setup guide. This also removes the need for the downstream 003-fix-docs-version.patch in reference_integration (follow-up PR).

With further fixes the docs/conf.py file can be removed completely.

@umaucher
umaucher deployed to workflow-approval August 21, 2026 11:59 — with GitHub Actions Active
@umaucher
umaucher deployed to workflow-approval August 21, 2026 11:59 — with GitHub Actions Active
@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run --lockfile_mode=error //:license-check

Status: ⚠️ Needs Review

Click to expand output
[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.6.0) and connecting to it...
INFO: Invocation ID: 265f7467-848a-4391-a322-f3684eb2ea7b
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Loading: 
Loading: 3 packages loaded
Loading: 3 packages loaded
    currently loading: 
Loading: 3 packages loaded
    currently loading: 
Loading: 3 packages loaded
    currently loading: 
Analyzing: target //:license-check (4 packages loaded, 0 targets configured)
Analyzing: target //:license-check (4 packages loaded, 0 targets configured)

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

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

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

Analyzing: target //:license-check (149 packages loaded, 3125 targets configured)

Analyzing: target //:license-check (149 packages loaded, 3125 targets configured)

Analyzing: target //:license-check (149 packages loaded, 3125 targets configured)

Analyzing: target //:license-check (160 packages loaded, 9292 targets configured)

Analyzing: target //:license-check (161 packages loaded, 9312 targets configured)

Analyzing: target //:license-check (167 packages loaded, 9445 targets configured)

Analyzing: target //:license-check (171 packages loaded, 11450 targets configured)

INFO: Analyzed target //:license-check (177 packages loaded, 11510 targets configured).
[9 / 17] checking cached actions
INFO: From Generating Dash formatted dependency file ...:
INFO: Successfully converted 66 packages from Cargo.lock to bazel-out/k8-fastbuild/bin/formatted.txt
[15 / 17] JavaToolchainCompileBootClasspath external/rules_java+/toolchains/platformclasspath.jar; 0s disk-cache, processwrapper-sandbox
INFO: Found 1 target...
Target //:license.check.license_check up-to-date:
  bazel-bin/license.check.license_check
  bazel-bin/license.check.license_check.jar
INFO: Elapsed time: 27.612s, Critical Path: 1.81s
INFO: 17 processes: 12 internal, 4 processwrapper-sandbox, 1 worker.
INFO: Build completed successfully, 17 total actions
INFO: Running command line: bazel-bin/license.check.license_check ./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

Copy link
Copy Markdown

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

Additionally remove the need for the downstream 003-fix-docs-version.patch in reference_integration. With further
fixes docs/conf.py gets obsolete and can be deleted.
@umaucher
umaucher force-pushed the um_docs_as_code_setup_update branch from 2166635 to c124414 Compare August 21, 2026 12:56
@umaucher
umaucher deployed to workflow-approval August 21, 2026 12:56 — with GitHub Actions Active
@umaucher
umaucher deployed to workflow-approval August 21, 2026 12:56 — with GitHub Actions Active
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant