Unit 14 · overview

Prerequisite Verification: Workspace, Package, Build, Overlay

This route no longer teaches ROS 2 workspace and colcon fundamentals as a new unit. Those belong in ros2-for-students.

The bridge task is to verify that a learner can distinguish the bringup layers before diagnosing a Java-to-ROS boundary problem.

From a known workspace, prove:

  • where source lives;
  • which package owns the bringup responsibility;
  • whether colcon build succeeded;
  • what was generated into build, install, and log;
  • whether the current shell has sourced the overlay;
  • whether the package is discoverable only after that environment boundary is satisfied.

A successful build and a sourced overlay are different claims. Neither one proves Java/WPILib integration or physical robot behavior.

Required checkpoint

Produce a Workspace Readiness Record with source path, package identity, build evidence, overlay evidence, one unsourced-shell failure, and one statement of what remains outside this evidence layer.

If workspace/package/overlay mechanics are unfamiliar, return to ros2-for-students instead of expanding this bridge route.