Guide Add-ins

Use these blocks when a guide needs extra structure.

Code Blocks

Add a language after the opening fence when you can:

terminal

ros2 pkg create waypoint_robot --build-type ament_python
cd waypoint_robot

motor-test.cpp

void loop() {
  setMotorPower(leftMotor, 120);
  setMotorPower(rightMotor, 120);
}

Inline code like ros2 launch and package.xml uses the same solid-color system.

Tips

Tip

Use tips for helpful shortcuts, reminders, or beginner-friendly context.

Warnings

Warning

Use warnings when a step can break hardware, waste parts, or create confusing debugging problems.

STOP Sections

STOP

Do not continue until your wiring, voltage, and motor driver orientation match your schematic.

Video Embeds

Use GuideVideo for walkthroughs, demos, or short build clips.

Replace this placeholder with a real embed URL when the guide has a video.

video-embed.mdx

import GuideVideo from '../../../components/GuideVideo.astro';

<GuideVideo
  title="PCB routing walkthrough"
  src="https://www.youtube.com/embed/VIDEO_ID"
  caption="A short walkthrough for routing the control PCB."
/>

Expandable Details

When should I use details?

Use details for optional explanations, troubleshooting notes, or extra context that would interrupt the main route.