fix(attributes): address review issues in AttributeCollection and inventory deprecation

- Add @validate_call to create() and update() in AttributeCollection
- Remove implementation details from update() docstring
- Add Notes section to update() listing updatable fields
- Fix add_specs() deprecation message: set_values -> add_values

Co-authored-by: Prasad <prasad-albert@users.noreply.github.com>

Author: github-actions[bot]

src/albert/collections/attributes.py

@@ -153,6 +153,7 @@ def get_by_ids(self, *, ids: list[AttributeId]) -> list[Attribute]:
         items = data.get("Items") or data.get("items") or []
         return [Attribute(**item) for item in items]
 
+    @validate_call
     def create(self, *, attribute: Attribute) -> Attribute:
         """Create a new attribute.
 
@@ -172,12 +173,10 @@ def create(self, *, attribute: Attribute) -> Attribute:
         response = self.session.post(self.base_path, json=payload)
         return Attribute(**response.json())
 
+    @validate_call
     def update(self, *, attribute: Attribute) -> Attribute:
         """Update an existing attribute.
 
-        Enum value changes are handled transparently via a separate enums
-        endpoint before applying any field-level patches.
-
         Parameters
         ----------
         attribute : Attribute
@@ -187,6 +186,11 @@ def update(self, *, attribute: Attribute) -> Attribute:
         -------
         Attribute
             The updated Attribute.
+
+        Notes
+        -----
+        The following fields can be updated: ``reference_name``, ``parameters``,
+        ``validation``, ``unit_id``.
         """
         if attribute.id is None:
             raise ValueError("Attribute ID is required for update.")

src/albert/collections/inventory.py

@@ -280,7 +280,7 @@ def get_specs(self, *, ids: list[InventoryId]) -> list[InventorySpecList]:
 
     @deprecated(
         "add_specs() is deprecated and will be removed in 2.0. "
-        "Use client.attributes.set_values() instead."
+        "Use client.attributes.add_values() instead."
     )
     @validate_call
     def add_specs(