Skip to content

process: add initial tool management #932

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

masc2023
Copy link
Contributor

Resolves: #858

Copy link

github-actions bot commented Apr 15, 2025

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run //:license-check

Status: ✅ Passed

Click to expand output
[License Check Output]
Extracting Bazel installation...
Starting local Bazel server and connecting to it...
INFO: Invocation ID: 32ad358d-22ad-4bef-9463-8764cfd7df83
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Loading: 
Loading: 0 packages loaded
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)

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

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

Analyzing: target //:license-check (132 packages loaded, 1596 targets configured)

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

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

Analyzing: target //:license-check (142 packages loaded, 2554 targets configured)

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

INFO: Analyzed target //:license-check (150 packages loaded, 4737 targets configured).
[11 / 13] [Prepa] JavaToolchainCompileBootClasspath external/rules_java~/toolchains/platformclasspath.jar
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: 16.709s, Critical Path: 0.43s
INFO: 13 processes: 4 disk cache hit, 9 internal.
INFO: Build completed successfully, 13 total actions
INFO: Running command line: bazel-bin/license.check.license_check ./formatted.txt -review -project automotive.score -repo https://github.com/eclipse-score/score -token otyhZ4eaRYK1tKLNNF-Y
[main] INFO Querying Eclipse Foundation for license data for 76 items.
[main] INFO Found 52 items.
[main] INFO Querying ClearlyDefined for license data for 24 items.
[main] INFO Found 24 items.
[main] INFO Vetted license information was found for all content. No further investigation is required.

Copy link

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

@masc2023 masc2023 force-pushed the masc2023_add_initial_tool_management branch from 3242aa0 to af8341c Compare April 15, 2025 09:41
@masc2023 masc2023 marked this pull request as ready for review April 15, 2025 09:48
@masc2023 masc2023 requested a review from aschemmel-tech April 15, 2025 09:48
@masc2023 masc2023 force-pushed the masc2023_add_initial_tool_management branch from af8341c to c0e3042 Compare April 16, 2025 07:03
@masc2023 masc2023 self-assigned this Apr 16, 2025
@masc2023 masc2023 force-pushed the masc2023_add_initial_tool_management branch from c0e3042 to f8a7453 Compare April 16, 2025 08:03
Copy link
Contributor

@aschemmel-tech aschemmel-tech left a comment

Choose a reason for hiding this comment

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

see inline comments


In case you want to use a tool within **S-CORE** consider to:

* Create your Tool Verification Report according to :need:`wf__tool__create_tool_verification_report`
Copy link
Contributor

Choose a reason for hiding this comment

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

First I think one should consider the tool list, if the tool and its use case is already part of it. And then one should follow the tool user guide. And only if it is not already there ...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

modified


The Tool Verification Report is created during identification of a tool.

Each identified tool to is evaluated and if applicable, qualified. During evaluation and
Copy link
Contributor

Choose a reason for hiding this comment

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

typo "to"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

changed


Finally the Tool Verification Report is verified and approved, and thus in Released state.

For creating the Tool Verification Report template must be used.
Copy link
Contributor

Choose a reason for hiding this comment

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

grammar "a template"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

changed

proper tool documentation, guidelines, protection against malware introduction, etc.

Based on TCL the appropriate qualification methods shall be applied. For S-CORE per default
the method validation of software tool must be used.
Copy link
Contributor

Choose a reason for hiding this comment

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

consider to put the method name in "" for better readability

Copy link
Contributor Author

Choose a reason for hiding this comment

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

changed

Tool Management Checklist
#########################

.. gd_chklst:: Tool Verification Report Review Checklist
Copy link
Contributor

Choose a reason for hiding this comment

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

mismatch to title above?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

changed

-------------
[Describe here detailed information about the tool documentation]

Where are the tool documents like User Manual, Guidelines, Erratas, etc. located?
Copy link
Contributor

Choose a reason for hiding this comment

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

I would like to have a tool list with all the information relevant for a user linked. So maybe we create a "tool" need with the respective attributes and generate the list from these?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

see below, tool list exist, but not on need, but id, tags, let's discuss the better approach in next meeting

-

* - 20
- If applicable, are the analyses for software tool qualification defined?
Copy link
Contributor

Choose a reason for hiding this comment

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

see also below: analysis needed?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

make it optional, let's discuss in next meeting

For each tool the :need:`gd_temp__tool_management__verif_rpt_template` shall be used to document
the relevant information.

:need:`gd_chklst__tool__cr_review` may used to check that all relevant information is considered.
Copy link
Contributor

Choose a reason for hiding this comment

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

sentence unclear, needed? why only "may"?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

changed, may was there, if it enforced by tool, may not needed?


**To Step 3**

If tool impact is judged to "YES" and tool error detection judged to "YES", the tool confidence
Copy link
Contributor

Choose a reason for hiding this comment

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

I think it should be "and tool error detection judged to "NO""

Copy link
Contributor Author

Choose a reason for hiding this comment

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

changed

.. list-table:: SW Platform tool overview
:header-rows: 1

* - tool Id
Copy link
Contributor

Choose a reason for hiding this comment

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

This is more a tool list for the "safety and security management". I would like to add here info/links relevant to the user like version, user manual, use case (or at least state that these are part of the "verification report").

Copy link
Contributor Author

Choose a reason for hiding this comment

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

add link, but see comment above, how to create tool list

@masc2023 masc2023 force-pushed the masc2023_add_initial_tool_management branch from f8a7453 to 37c6d46 Compare April 25, 2025 10:23
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.

Epic: (Initial) Tool Management
2 participants