Tutorials¶
These tutorials test how NoDL fits real ROS 2 development workflows. The first pass uses nodes from
ros2/demos and stays within the capabilities available on NoDL main.
Important
The Basics and Dummy robot tutorials have current, executable subsets. The Nav2 ControllerServer tutorial
is a target workflow for composition. nodl_schema can resolve include references, but NoDL does not yet provide
forward generation, semantic diff, or expected-versus-observed conformance. Each tutorial separates commands that
work today from a clearly labelled target workflow.
Available tutorials¶
ROS 2 basics¶
Describe, curate, validate, and register the same small publisher interface in C++ and Python.
Dummy robot¶
Apply the current workflow to a visible robot system, a laser publisher, and TF-related system requirements.
Nav2 ControllerServer¶
Show how a NoDL document would compose lifecycle, bond, TF, and common Nav2 conventions with a node-specific action server and topic endpoints.
Tutorial roadmap¶
Five tutorials remain the target suite. The table distinguishes implemented documentation from planned work.
Tutorial |
Upstream target |
Status |
Adoption question |
|---|---|---|---|
|
Prototype available |
How does one NoDL interface map to C++ and Python? |
|
|
Prototype available |
How does the workflow scale to a visible multi-node robot? |
|
Pendulum control |
|
TBD |
Can NoDL migrate interfaces without owning real-time behavior? |
ros2_control |
|
TBD |
How do framework-provided capabilities compose? |
|
Target workflow |
Can composition scale across ecosystem bases? |
Recommended talk path¶
Use Dummy robot for the full ROSCon narrative because RViz makes the result visible. Use ROS 2 basics only for a short syntax and C++/Python introduction. The later framework tutorials are scaling evidence, not extra live demos.
Conformance is not a separate sixth tutorial. Each track will add an intentional regression when the conformance command is available.