diff --git a/src/pybricks/_common.py b/src/pybricks/_common.py index 13c2827..75d30d3 100644 --- a/src/pybricks/_common.py +++ b/src/pybricks/_common.py @@ -416,10 +416,12 @@ class Motor(DCMotor): Choose ``False`` to keep the current value, so your program knows where it left off last time. - profile (Number, deg): Precision profile. A lower value - means more precise movement; a larger value means - smoother movement. If no value is given, a suitable profile for - this motor type will be selected automatically. + profile (Number, deg): Precision profile. This is the approximate + position tolerance in degrees that is acceptable in your + application. A lower value gives more precise but more erratic + movement; a higher value gives less precise but smoother + movement. If no value is given, a suitable profile for this + motor type will be selected automatically (about 11 degrees). """ def angle(self) -> int: diff --git a/src/pybricks/pupdevices.py b/src/pybricks/pupdevices.py index ee4862f..19a464d 100644 --- a/src/pybricks/pupdevices.py +++ b/src/pybricks/pupdevices.py @@ -70,10 +70,12 @@ class Motor(_common.Motor): Choose ``False`` to keep the current value, so your program knows where it left off last time. - profile (Number, deg): Precision profile. A lower value - means more precise movement; a larger value means - smoother movement. If no value is given, a suitable profile for - this motor type will be selected automatically. + profile (Number, deg): Precision profile. This is the approximate + position tolerance in degrees that is acceptable in your + application. A lower value gives more precise but more erratic + movement; a higher value gives less precise but smoother + movement. If no value is given, a suitable profile for this + motor type will be selected automatically (about 11 degrees). """ def reset_angle(self, angle: Optional[Number] = None) -> None: