Skip to content

Add time slave component requirements - #151

Open
ryan-steel wants to merge 4 commits into
eclipse-score:mainfrom
etas-contrib:add-time_slave-component-requirements
Open

Add time slave component requirements#151
ryan-steel wants to merge 4 commits into
eclipse-score:mainfrom
etas-contrib:add-time_slave-component-requirements

Conversation

@ryan-steel

@ryan-steel ryan-steel commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Improvement

Description

Add initial component documentation for time_slave following S-CORE process:

  • Component requirements (docs/requirements/)
  • Architecture boilerplate (docs/architecture/) to give us valid needs to link against (comp__time_slave) - these are the template files from module_template, the only changes I've made were to update IDs, the rest of the content should be filled in a future PR.

All status: invalid (draft) pending review.

Important

The added docs won't be built until the changes in #148 for updating to docs_as_code 6.0 and using docs bundles is merged. I've run the build locally with those changes implemented and the docs build without error.

Related ticket

Part of #96

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run //: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: eaae2de7-4846-4795-a64b-3569e1313297
Computing main repo mapping: 
WARNING: /home/runner/work/time/time/MODULE.bazel:13:7: The attribute 'compatibility_level' in module() is a no-op and will be removed in a future Bazel release. Please remove it from your MODULE.bazel file.
Computing main repo mapping: 
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: 
Loading: 3 packages loaded
    currently loading: 
Analyzing: target //:license-check (4 packages loaded)
Analyzing: target //:license-check (4 packages loaded, 0 targets configured)
Analyzing: target //:license-check (4 packages loaded, 0 targets configured)

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

Analyzing: target //:license-check (95 packages loaded, 30 targets configured)

Analyzing: target //:license-check (144 packages loaded, 3098 targets configured)

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

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

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

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

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

Analyzing: target //:license-check (166 packages loaded, 9408 targets configured)

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

INFO: Analyzed target //:license-check (170 packages loaded, 11422 targets configured).
[5 / 14] checking cached actions
INFO: From Generating Dash formatted dependency file ...:
INFO: Successfully converted 2 packages from Cargo.lock to bazel-out/k8-fastbuild/bin/formatted.txt
[13 / 16] JavaToolchainCompileClasses external/rules_java+/toolchains/platformclasspath_classes; 0s disk-cache, processwrapper-sandbox
[14 / 16] 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: 28.333s, Critical Path: 2.48s
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>]

@ryan-steel
ryan-steel marked this pull request as ready for review August 5, 2026 13:29
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

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

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Adds initial S-CORE process documentation scaffolding for the score/time_slave component, introducing draft requirements and architecture artefacts to establish traceable needs for future work.

Changes:

  • Added initial component requirements (comp_req / aou_req) and a requirements inspection checklist.
  • Added architecture boilerplate (static/dynamic views) and an architecture inspection checklist.
  • Updated the component documentation landing page to reference the new sections.

Reviewed changes

Copilot reviewed 7 out of 9 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
score/time_slave/docs/index.rst Reworked component landing page and toctree to point at requirements/architecture.
score/time_slave/docs/requirements/index.rst Introduces requirements section toctree.
score/time_slave/docs/requirements/requirements.rst Adds initial component requirements and AoU needs for time_slave.
score/time_slave/docs/requirements/chklst_req_inspection.rst Adds requirements inspection checklist template for the component.
score/time_slave/docs/requirements/.gitkeep Placeholder file for requirements directory.
score/time_slave/docs/architecture/index.rst Introduces architecture section toctree.
score/time_slave/docs/architecture/component_architecture.rst Adds architecture boilerplate including comp, static view, and dynamic view needs.
score/time_slave/docs/architecture/chklst_arc_inspection.rst Adds architecture inspection checklist template for the component.
score/time_slave/docs/architecture/.gitkeep Placeholder file for architecture directory.
Suppressed comments (2)

score/time_slave/docs/architecture/chklst_arc_inspection.rst:181

  • Typo in quoted string: ""n/a" has an extra quote, which reads oddly in the rendered docs.
Note: If a Review ID is not applicable for your architecture, then state ""n/a" in status and comment accordingly in remarks.

score/time_slave/docs/architecture/component_architecture.rst:74

  • The :belongs_to: target feat__time is not defined anywhere in this repository (search only finds this reference). If the feature need lives in an external bundle, please make sure it’s available when building these docs; otherwise update this link to an existing feature need ID.
   :belongs_to: feat__time

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


.. document:: Time Slave
:id: doc__time_slave
:status: valid

- content responsible (author): <contributor/committer explicitly named here, who is the main author, as can be seen in config mgt tooling>
- reviewer: <contributor/committer explicitly named here, who is the main content reviewer, must be different from content responsible>
- moderator: <committer explicitly named here, who is is the safety manager, security manager or quality manager initiating the inspection>

- content responsible (author): <contributor/committer explicitly named here, who is the main author, as can be seen in config mgt tooling>
- reviewer: <contributor/committer explicitly named here, who is the main content reviewer, must be different from content responsible>
- moderator: <committer explicitly named here, who is is the safety manager, security manager or quality manager initiating the inspection>
:reqtype: Functional
:security: NO
:safety: QM
:derived_from: feat_req__time__vehicle_time_sync[version==1]
The components are designed to cover the expectations from the feature architecture
(i.e. if already exists a definition it should be taken over and enriched).

A component can optional also consist of lower level components to further structure the architecture. The component and its static views can also optionally use interfaces provided by other components.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

2 participants