Skip to content

Commit b76eb88

Browse files
committed
docs(roadmap): add platform/toolchain bullet, ref-int integration item, and Terminology section
1 parent 4b14d66 commit b76eb88

2 files changed

Lines changed: 37 additions & 0 deletions

File tree

docs/s_core_v_1/roadmap/pi1.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@ Focus: Requirements Engineering (PA2) + Architecture Design (PA3)
2929
is either completed or the finding is noted in the checklist with a tracked issue;
3030
each tracked issue must have the **team** set and the **milestone** set
3131
- All requirements relevant for v1.0 must be explicitly marked as such
32+
- The current state of every module — including its implementation — must be
33+
integrated into the ``reference_integration`` repository
3234
- Implementation of functionality must be planned via tickets in the
3335
`main S-CORE GitHub project <https://github.com/orgs/eclipse-score/projects>`__ —
3436
each ticket must have the **team** set and the **milestone** set
@@ -99,6 +101,16 @@ Work Breakdown
99101
shall be tracked by tickets. Each ticket must be assigned to a milestone
100102
less than or equal to ``v1.0``, have the dedicated **team** attribute set,
101103
and have its **process area** set to ``pa4_impl``.
104+
- Define the set of **target platforms** that S-CORE officially supports
105+
for v1.0. For every supported platform there shall be an **official
106+
toolchain**, and the ``reference_integration`` repository shall provide
107+
a dedicated CI/CD workflow that compiles every module against that
108+
platform's toolchain. Every implementation module must be **buildable
109+
with this toolchain**, and it is **strongly recommended** that each
110+
module reuses the same toolchain definition locally instead of
111+
maintaining its own. The supported platforms together with their
112+
official toolchains shall be **properly documented** so that every
113+
module owner can refer to a single authoritative source.
102114
- Create and fully complete the Module Verification Report for every
103115
module. All findings shall be documented as tickets assigned to a
104116
milestone less than or equal to ``v1.0``, with the corresponding

docs/s_core_v_1/roadmap/planning_approach.rst

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,3 +79,28 @@ example ``pa1_req_eng``, ``pa2_arch_design``, ``pa3_implementation``,
7979
only **by time** (milestone / release gate) but also **by function**
8080
(process area), which is what feeds the per-process-area views on the
8181
:doc:`Overall Status <overall_status>` page.
82+
83+
Terminology
84+
-----------
85+
86+
To keep the planning vocabulary unambiguous, the following terms are used
87+
consistently throughout this section:
88+
89+
- **Version** — A *version* refers to a software product version in the
90+
classical sense: a defined, released state of the S-CORE platform with a
91+
fixed scope and quality (e.g. ``v0.5``, ``v1.0``). It is the unit that is
92+
shipped to and consumed by users of the platform.
93+
- **Release / Milestone** — A *release* (also called *milestone*, mapped
94+
one-to-one to a `GitHub milestone
95+
<https://github.com/eclipse-score/score/milestones>`__) is a planning
96+
checkpoint that we use to **track our work on the way to a version**.
97+
Several releases / milestones (e.g. ``v0.8``, ``v0.9``, ``v0.10``)
98+
typically lead up to a single version (``v1.0``).
99+
- **Release Gate** — A *release gate* is the set of deliverables that, by
100+
the corresponding release / milestone, **must be done for sure** in order
101+
to keep the path to the target version on track. The release gate
102+
documents the **mandatory minimum**; it does **not** restrict the teams
103+
to working only on the items listed there. Teams are free to work on
104+
additional topics in parallel — the release gate simply makes explicit
105+
what is non-negotiable for that milestone.
106+

0 commit comments

Comments
 (0)