Skip to content

docs: update to supported formats#124

Open
PiotrKorkus wants to merge 1 commit intoeclipse-score:mainfrom
qorix-group:piotrkorkus_docs_cleanup
Open

docs: update to supported formats#124
PiotrKorkus wants to merge 1 commit intoeclipse-score:mainfrom
qorix-group:piotrkorkus_docs_cleanup

Conversation

@PiotrKorkus
Copy link
Copy Markdown
Contributor

  • Markdown files were not included in documentation and not rendered anywhere
  • Relative links markdown files were reporting errors in docs_combo_build in reference_integration
  • .uxf is not supported by sphinx-needs

Please double check diagrams, as I used AI to convert them into PlantUML and they were not rendered anywhere for comparison.

Bugfix

Important

Use this template only for bugfixes that do not influence topics covered by contribution requests or improvements.

Caution

Make sure to submit your pull-request as Draft until you are ready to have it reviewed by the Committers.

Description

[A short description of the bug being fixed by the contribution.]

Related ticket

Important

Please replace [ISSUE-NUMBER] with the issue-number that tracks this bug fix. If there is no such
ticket yet, create one via this issue template.

closes [ISSUE-NUMBER] (bugfix ticket)

- move md to rst
- regenerate diagrams in plantuml
@github-actions
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.4.2) and connecting to it...
INFO: Invocation ID: c32a3492-fd44-449b-b73c-880ff4634e9d
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
WARNING: For repository 'score_rust_policies', the root module requires module version score_rust_policies@0.0.3, but got score_rust_policies@0.0.5 in the resolved dependency graph. Please update the version in your MODULE.bazel or set --check_direct_dependencies=off
Loading: 
Loading: 0 packages loaded
Loading: 0 packages loaded
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)

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

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

Analyzing: target //:license-check (145 packages loaded, 1975 targets configured)

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

Analyzing: target //:license-check (154 packages loaded, 5922 targets configured)

Analyzing: target //:license-check (165 packages loaded, 7899 targets configured)

Analyzing: target //:license-check (165 packages loaded, 7901 targets configured)

Analyzing: target //:license-check (165 packages loaded, 7901 targets configured)

Analyzing: target //:license-check (168 packages loaded, 9789 targets configured)

Analyzing: target //:license-check (168 packages loaded, 9789 targets configured)

Analyzing: target //:license-check (169 packages loaded, 9913 targets configured)

INFO: Analyzed target //:license-check (170 packages loaded, 10039 targets configured).
[12 / 16] JavaToolchainCompileClasses external/rules_java+/toolchains/platformclasspath_classes; 0s disk-cache, processwrapper-sandbox ... (2 actions running)
[14 / 16] JavaToolchainCompileBootClasspath external/rules_java+/toolchains/platformclasspath.jar; 0s disk-cache, processwrapper-sandbox
INFO: Found 1 target...
[16 / 16] no actions running
Target //:license.check.license_check up-to-date:
  bazel-bin/license.check.license_check
  bazel-bin/license.check.license_check.jar
INFO: Elapsed time: 26.440s, Critical Path: 2.67s
INFO: 16 processes: 12 internal, 3 processwrapper-sandbox, 1 worker.
INFO: Build completed successfully, 16 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>]

@PiotrKorkus PiotrKorkus requested a review from pawelrutkaq March 18, 2026 13:09
@github-actions
Copy link
Copy Markdown

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

@pawelrutkaq
Copy link
Copy Markdown
Contributor

@NicolasFussberger / @SimonKozik can you have a look


module/*/index
module/lifecycle_client_lib/lifecycle
module/lifecycle_client_lib/lifecyclemanager
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should introduce a subfolder for launch_manager here inbetween.
Otherwise, these lifecycle_client_lib APIs are visible at the top-level:

Image

}

App --|> mwApp : <<uses>>
App --> LifecycleManager : manages (run, terminate)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

direction of the arrow is wrong

class "Application Context" as AppCtx #0000FF {
}

App --|> mwApp : <<uses>>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

original diagram says App --> mwApp : implements
and it is not an inheritance arrow but an implements arrow


LifecycleManager --> ExecMgr : reports state (run, terminate)
LifecycleManager --> OS : handles application SIGTERM

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The original diagram also depicted this link:

ExecMgr --> LifecycleManager : handles application SIGTERM

Image

LifecycleManager --> ExecMgr : reports state (run, terminate)
LifecycleManager --> OS : handles application SIGTERM

AppCtx --> ExecMgr : starts
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The direction of the arrow is wrong

mw::lifecycle
end note

@enduml
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@PiotrKorkus would you be so kind to check the other diagrams first?
It seems the AI conversion introduced a bunch of errors.
You can use umlet-standalone to view the original uxf diagrams

@PiotrKorkus
Copy link
Copy Markdown
Contributor Author

Hi @NicolasFussberger,

thanks for checking those diagrams. Those changes are needed for reference_integration build as lifecycle blocks building its documentation there.
I will be able to update this PR next week the earliest, so if you could take over this PR that is more than welcome to unblock reference_integration.

@NicolasFussberger
Copy link
Copy Markdown
Contributor

Hi @NicolasFussberger,

thanks for checking those diagrams. Those changes are needed for reference_integration build as lifecycle blocks building its documentation there. I will be able to update this PR next week the earliest, so if you could take over this PR that is more than welcome to unblock reference_integration.

We discussed in the last lifecycle meeting that @jaakkoaho will have a look at these changes.

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.

Names of modules' index and single index per module.

3 participants