Skip to content

Commit dcdf12d

Browse files
committed
docs(roadmap): add Planning Approach page
- New planning_approach.rst summarising how v1.0 is planned: GitHub project, Product Increment tickets per Feature Team / Community mapped to milestones, sub-tickets and the GitHub project's process area attribute for grouping. - Link to the authoritative Platform Management Plan as primary reference. - Add the page to the roadmap toctree (after Overall Status).
1 parent c7d75ba commit dcdf12d

2 files changed

Lines changed: 82 additions & 0 deletions

File tree

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
..
2+
# *******************************************************************************
3+
# Copyright (c) 2026 Contributors to the Eclipse Foundation
4+
#
5+
# See the NOTICE file(s) distributed with this work for additional
6+
# information regarding copyright ownership.
7+
#
8+
# This program and the accompanying materials are made available under the
9+
# terms of the Apache License Version 2.0 which is available at
10+
# https://www.apache.org/licenses/LICENSE-2.0
11+
#
12+
# SPDX-License-Identifier: Apache-2.0
13+
# *******************************************************************************
14+
15+
:hide-toc:
16+
17+
.. _v1_0_planning_approach:
18+
19+
Planning Approach
20+
=================
21+
22+
.. note::
23+
24+
This page is **a short summary** of how the S-CORE v1.0 roadmap is
25+
planned. The authoritative planning procedure — covering project
26+
management, release management, change management and the underlying
27+
governance — is described in the
28+
`Platform Management Plan
29+
<https://eclipse-score.github.io/score/main/platform_management_plan/index.html>`__
30+
(in particular
31+
`Project Management
32+
<https://eclipse-score.github.io/score/main/platform_management_plan/project_management.html>`__
33+
and
34+
`Release Management
35+
<https://eclipse-score.github.io/score/main/platform_management_plan/release_management.html>`__).
36+
37+
Where we plan
38+
-------------
39+
40+
All v1.0 planning is tracked in the central GitHub project
41+
`S-CORE v1.0 Planning <https://github.com/orgs/eclipse-score/projects/17/views/37>`__.
42+
This project is the single source of truth for the roadmap; the figures and
43+
tables shown elsewhere in this section are derived from it.
44+
45+
Product Increments per Feature Team / Community
46+
-----------------------------------------------
47+
48+
Every Feature Team and every Community creates **one ticket of type
49+
"Product Increment"** for each release gate they contribute to. This ticket:
50+
51+
- is the **main ticket** for the team's work in that release gate,
52+
- is **mapped to the corresponding milestone** (using the ticket's
53+
*milestone* attribute) in the
54+
`eclipse-score/score milestones
55+
<https://github.com/eclipse-score/score/milestones>`__ (e.g. ``v0.8``,
56+
``v0.9``, ``v0.10``, ``v1.0``), and
57+
- represents the team's commitment for that release gate.
58+
59+
Sub-tickets — the actual work
60+
-----------------------------
61+
62+
All work the team performs for the corresponding milestone / release gate is
63+
**linked as sub-tickets under the Product Increment ticket**.
64+
65+
- The breakdown does **not need to be exhaustive**; it can be detailed if a
66+
team wants to, but at a minimum it should reflect the **main achievements
67+
or work packages** planned for that release gate.
68+
- The sub-ticket structure ensures that the Product Increment ticket gives a
69+
meaningful overview of the team's scope without having to dig through every
70+
individual issue.
71+
72+
Process-area attribute
73+
----------------------
74+
75+
Wherever possible, each sub-ticket sets the **process area** GitHub project's
76+
attribute, for
77+
example ``pa1_req_eng``, ``pa2_arch_design``, ``pa3_implementation``,
78+
``pa4_verification``. This makes it possible to group and filter tickets not
79+
only **by time** (milestone / release gate) but also **by function**
80+
(process area), which is what feeds the per-process-area views on the
81+
:doc:`Overall Status <overall_status>` page.

docs/s_core_v_1/roadmap/roadmap.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,7 @@ Status & Next Steps
194194
:maxdepth: 1
195195

196196
Overall Status <overall_status>
197+
Planning Approach <planning_approach>
197198
Release Gate v0.8 — Requirements Engineering + Architecture Design <pi1>
198199
Release Gate v0.9 — Implementation <pi2>
199200
Release Gate v0.10 — Verification <pi3>

0 commit comments

Comments
 (0)