drivers: stepper: api: rename enable_constant_velocity_mode to run

[jilaypandya]

rename enable_constant_velocity_mode to run in following files:

• include/zephyr/drivers/stepper.h
• include/zephyr/drivers/stepper/stepper_fake.h
• doc/hardware/peripherals/stepper.rst
• doc/releases/migration-guide-4.1.rst
• drivers/stepper/adi_tmc/adi_tmc5041_stepper_controller.c
• drivers/stepper/fake_stepper_controller.c
• drivers/stepper/gpio_stepper_controller.c
• drivers/stepper/stepper_shell.c
• tests/drivers/stepper/shell/src/main.c

[kartben]

Suggested change

	* @brief run the stepper with a given velocity in a given direction
	* @brief Run the stepper with a given velocity in a given direction

[kartben]

I suggest renaming the value parameter to velocity as its name is now pretty vague otherwise. Please also fix inconsistency below as it says velocity is in steps/s in one place, and steps/us in another.

Also the @details still mentions "constant velocity mode" which might be confusing?

[bjarki-andreasen]

Really like the new API name, the velocity_in_usteps_per_second is a bit, wordy, I would go with velocity_ustep_sec and expand its meaning in the @param but its fine either way :)

[kartben]

I tend to agree with @bjarki-andreasen about the verbosity. Also, did you want to rename the value parameter in the driver implementations too, for clarity? Also wonder about dropping "constant velocity" from L418-L419 in the stepper.h header, maybe just refer to "Run the stepper motor with the given ... / Stop the stepper motor"?
Will eventually approve if you don't feel like changing again, as it's probably borderline nitpicking :) just let me know :)

[jilaypandya]

Will eventually approve if you don't feel like changing again, as it's probably borderline nitpicking :) just let me know :)

I like borderline nitpicking :-) waiting for #82283 to get merged, will then rebase and force push :)

[jilaypandya]

sorry guys, the CI should pass now