feat: update roadmap with timelines (#767)

xmfcx · web-flow · commit 9e0047f29302 · 2026-01-13T10:03:37.000+03:00
Signed-off-by: Mete Fatih Cırıt &lt;mfc@autoware.org&gt;
diff --git a/docs/home/roadmap/.pages b/docs/home/roadmap/.pages
@@ -1,2 +1,3 @@
 nav:
-  - index.md
+  - timelines
+  - multi-year-roadmap.md
diff --git a/docs/home/roadmap/multi-year-roadmap.md b/docs/home/roadmap/multi-year-roadmap.md
diff --git a/docs/home/roadmap/timelines/.pages b/docs/home/roadmap/timelines/.pages
@@ -0,0 +1,3 @@
+nav:
+  - Humble to Jazzy: humble-jazzy.md
+  - point-types.md
diff --git a/docs/home/roadmap/timelines/carla-simulator-support.md b/docs/home/roadmap/timelines/carla-simulator-support.md
@@ -0,0 +1,5 @@
+# Carla simulator support
+
+!!! warning
+
+    Under construction.
diff --git a/docs/home/roadmap/timelines/humble-jazzy.md b/docs/home/roadmap/timelines/humble-jazzy.md
@@ -0,0 +1,56 @@
+# ROS 2 Humble to Jazzy transition
+
+Tracked in [Support ROS 2 Jazzy Jalisco #6695](https://github.com/autowarefoundation/autoware/issues/6695).
+
+- ROS 2 Humble will reach the end of life on May 2027.
+- ROS 2 Jazzy has been released in May 2024 and will be supported until May 2029.
+
+This timeline is for Autoware's transition:
+
+- **From:** Ubuntu 22.04 | ROS 2 **Humble**
+- **To:** Ubuntu 24.04 | ROS 2 **Jazzy**
+
+```mermaid
+timeline
+    title ROS 2 Humble to Jazzy Transition
+    2026 Feb : Jazzy Docker Beta
+             : Optional CI Checks
+    2026 Apr : Jazzy Full Support
+             : Dual CI Coverage
+    2027 Jan : Humble Soft-Freeze
+             : Standard Support Ends
+    2027 May : Jazzy Exclusive Mode
+             : Humble End of Support
+```
+
+```mermaid
+gantt
+    title ROS 2 Transition: Humble to Jazzy
+    dateFormat  YYYY-MM-DD
+    axisFormat  %b '%y
+    tickInterval 1month
+
+    %% Define Milestones (Vertical markers for key dates)
+    section Key Events
+    Jazzy Docker Beta       :milestone, m1, 2026-02-01, 0d
+    Jazzy Full Support    :milestone, m2, 2026-04-01, 0d
+    Humble Soft-Freeze      :milestone, m3, 2027-01-01, 0d
+    Jazzy Exclusive         :milestone, m4, 2027-05-01, 0d
+
+    %% Section 1: The Outgoing Platform
+    section ROS 2 Humble
+    Standard Support        :active,    h_std,  2026-01-01, 2027-01-01
+    Low Maintenance (Crit Fixes) :crit, h_low,  after h_std, 2027-05-01
+    End of Support          :done,      h_end,  after h_low, 1d
+
+    %% Section 2: The Incoming Platform
+    section ROS 2 Jazzy
+    Docker Base Preview     :           j_beta, 2026-02-01, 2026-04-01
+    Full Support (Ubuntu 24.04) :active, j_std,  after j_beta, 2027-06-01
+
+    %% Section 3: Developer Action Items
+    section CI Policy
+    Optional Checks:           ci_opt, 2026-02-01, 2026-04-01
+    Mandatory Dual Coverage :crit,      ci_man, 2026-04-01, 2027-05-01
+    Jazzy Only              :active,    ci_jaz, after ci_man, 2027-06-01
+```
diff --git a/docs/home/roadmap/timelines/point-types.md b/docs/home/roadmap/timelines/point-types.md
@@ -0,0 +1,63 @@
+# Point cloud type transition
+
+Tracked under [this issue](https://github.com/autowarefoundation/autoware/issues/6708).
+
+Autoware transitions from using raw memcpy operations and using [PointCloud2Iterator<>](https://github.com/ros2/common_interfaces/blob/jazzy/sensor_msgs/include/sensor_msgs/point_cloud2_iterator.hpp) to using [Point Cloud Message Wrapper](https://gitlab.com/ApexAI/point_cloud_msg_wrapper).
+
+This way the point cloud messages can be edited in-place with a `std::vector<>`-like wrapper.
+
+The only downside is that this requires strong type definitions for the point cloud message fields.
+
+We have already made the compatibility requirements for `PointXYZIRC` and `PointXYZIRCAEDT` types with [this PR](https://github.com/autowarefoundation/autoware_universe/pull/6996).
+
+Now we need to start using this wrapper in the rest of the codebase.
+
+We also need to provide a tool to convert point cloud messages from outside types to the Autoware expected types.
+
+Reference implementation of [Point Type Adapter Node can be found here](https://gitlab.com/autowarefoundation/autoware.auto/AutowareAuto/-/blob/master/src/tools/point_type_adapter/src/point_type_adapter_node.cpp).
+
+## Transition
+
+1. **2026 May:** Switch all memcpy usages to `PointCloud2Iterator<>`.
+2. **2026 June:** Add two paths for the codebase: check the full compatibility of the point type with the expected point type.
+   - If compatible, use the wrapper.
+   - If not compatible, use `PointCloud2Iterator<>` and print warnings.
+3. **2026 June:** Add a node that converts point cloud messages from outside types to the Autoware expected types.
+4. **2026 December:** Drop the `PointCloud2Iterator<>` usage.
+
+```mermaid
+timeline
+    title Autoware Point Cloud Type Transition
+    section Standardization
+        2026 May : Stop raw memcpy operations
+                 : Migrate all access to PointCloud2Iterator
+    section Adoption & Tooling
+        2026 June : Implement Dual Path Logic
+                  : Use Wrapper if compatible
+                  : Fallback to Iterator (with warnings) if incompatible
+                  : Release Point Type Adapter Node
+    section Finalization
+        2026 December : Drop PointCloud2Iterator fallback
+                      : Full Point Cloud Msg Wrapper enforcement
+```
+
+```mermaid
+gantt
+    title Autoware Point Cloud Type Transition Plan
+    dateFormat  YYYY-MM-DD
+    axisFormat  %b %Y
+
+    section Phase 1: Standardization
+    Migrate memcpy to PointCloud2Iterator       :done, p1, 2026-05-01, 2026-06-01
+
+    section Phase 2: Dual Implementation
+    Implement Dual Path (Wrapper or Fallback)   :active, p2, 2026-06-01, 2026-12-01
+    Develop Point Type Adapter Node             :p3, 2026-06-01, 30d
+
+    section Phase 3: Finalization
+    Drop Iterator Support (Enforce Wrapper)     :crit, p4, 2026-12-01, 2026-12-31
+```
+
+!!! warning
+
+    Under construction.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+nav:`
	`2`	`+ - Humble to Jazzy: humble-jazzy.md`
	`3`	`+ - point-types.md`