doc/robotics: add note for using individual motors

pybricks · May 1, 2020 · 81fa637 · 81fa637
1 parent a74afd9
commit 81fa637
Showing 1 changed file with 11 additions and 0 deletions.
diff --git a/doc/api/robotics.rst b/doc/api/robotics.rst
@@ -74,6 +74,17 @@
     ``wheel_diameter`` first, as done above. Be sure to test both turning
     and driving straight after you are done.
 
+    .. rubric:: Using the DriveBase motors individually
+
+    Suppose you make a :class:`.DriveBase` object using two ``Motor`` objects called
+    ``left_motor`` and ``right_motor``. You **cannot** use these motors
+    individually while the DriveBase is **active**.
+
+    The DriveBase is active if it is driving, but also when it is actively
+    holding the wheels in place after a :meth:`.straight` or
+    :meth:`.turn` command.
+    To deactivate the :class:`.DriveBase`, call :meth:`.stop`.
+
 
     .. rubric:: Advanced Settings