Remove deprecated robot_id parameter from utils.read_yaml()

[b-Tomas]

Summary

• Remove the deprecated robot_id parameter from read_yaml() in utils.py and all associated branching logic
• Remove import warnings from utils.py — no longer needed
• Remove two tests that exercised the deprecated robot_id behavior (test_read_yaml_returns_specific_robot, test_read_yaml_raises_error_when_robot_id_not_present)
• Simplify the read_yaml specification in docs/contents/specification/utils.md

Breaking changes

read_yaml() no longer accepts a robot_id parameter. Passing it will raise a TypeError.

Migration

# Before (v2.x)
config = read_yaml("config.yaml", "robot_1")

# After (v3.0) — option A: index manually
config = read_yaml("config.yaml")["robot_1"]

# After (v3.0) — option B (recommended): use ConnectorConfig
config = ConnectorConfig(**read_yaml("config.yaml"))

[Copilot]

Pull request overview

This PR removes the deprecated robot_id parameter from inorbit_connector.utils.read_yaml() and updates the related tests and documentation to reflect the simplified configuration-loading behavior.

Changes:

• Removed the robot_id argument and all deprecation-warning branching logic from read_yaml().
• Deleted tests that exercised the deprecated robot_id selection behavior.
• Simplified the read_yaml utility specification docs to match the new API.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
tests/test_utils.py	Removes tests tied to the deprecated robot_id behavior.
inorbit_connector/utils.py	Updates read_yaml() signature and simplifies implementation; drops warnings import.
docs/contents/specification/utils.md	Updates the read_yaml specification to remove robot_id behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.