DOCS-2313: Clean up gantry, camera, board, encoder and arm pages for docs parsing

[sguequierre]

Questions:

• Is there any way to manually add a link for a type in the docstrings?

[github-actions]

Warning your change may break code samples. If your change modifies any of the following functions please contact @viamrobotics/fleet-management. Thanks!

component	function
base	is_moving
board	gpio_pin_by_name
camera	get_image
encoder	get_position
motor	is_moving
sensor	get_readings
servo	get_position
arm	get_end_position
gantry	get_lengths
gripper	is_moving
movement_sensor	get_linear_acceleration
input_controller	get_controls
audio	get_properties
pose_tracker	get_poses
power_sensor	get_power
motion	get_pose
vision	get_properties

[andf-viam]

Great start! Thanks @sguequierre !

• Yes, you should omit timeout and extra. We scrape these from the initial usage declaration of the method (first line) and not from the Properties section. I believe the SDK-team intent is to omit these SDK-wide. Only motion included them explicitly, and should likely remove them also.
• Yes, for docs.viam.com. We can manually add a link using the python_datatype_links array in update_sdk_methods.py. For the upstream SDK docs site though, I'd ask the team here: "any way to manually provide links here outside of the automated linking that occurs during make documentation?" Sierra, you made an excellent observation that some existing generated links by this step appear incorrect: "the resource type links are a bit tricky, as far as I can tell this is done automatically by some scraper/parser and it is not always correct (See base Properties linking to audioinput).

[stuqdog]

Nice, thanks for doing this! A couple small things, but otherwise this looks great.

[stuqdog]

The idiom in python is to not provide docstring comments for extra and timeout, so we should remove these (and the same comments in below methods). It looks like the same comment is used here as in motion; sorry for the confusion! The motion doc comments should probably get removed at some point.

[sguequierre]

Ok, thank you!

[stuqdog]

The linter is complaining about this line (and some others) that they're too long; can we cut this down or break it into multiple lines?

[sguequierre]

• any way to manually provide links here outside of the automated linking that occurs during make documentation?

@stuqdog do you know about this? No worries if not

[stuqdog]

• any way to manually provide links here outside of the automated linking that occurs during make documentation?

@stuqdog do you know about this? No worries if not

Ah good question! I'm not sure, but @njooma might know?

[andf-viam]

LGTM, thank you!