docs: address fresh-eyes review on Favorites docstrings

- Class docstring: add missing "collections" FavoriteType (7, not 6).
- add_favorite: drop misleading #add_workbook_to_favorites anchor on
  polymorphic method; link to Favorites Methods page root.
- add_favorite_metric: add REST API link (#add_metric_to_favorites).
- delete_favorite: add REST API link; polymorphic, so page root.
- delete_favorite_metric: add REST API link; no per-type anchor exists,
  so page root.
- delete_favorite_flow: fix anchor drift (#delete_flow_from_favorites
  -> #ref_delete_flow_from_favorites).

Author: jacalata

tableauserverclient/server/endpoint/favorites_endpoint.py

@@ -19,11 +19,12 @@
 class Favorites(Endpoint):
     """Get, add, and remove favorites for a user.
 
-    Favorites can be workbooks, views, datasources, flows, projects, or metrics.
-    Retrieved favorites are stored on the target ``UserItem`` object as a
-    dictionary keyed by content type (e.g. ``"workbooks"``, ``"views"``,
-    ``"datasources"``, ``"flows"``, ``"projects"``, ``"metrics"``), where
-    each value is a list of the corresponding item objects.
+    Favorites can be workbooks, views, datasources, flows, projects, metrics,
+    or collections. Retrieved favorites are stored on the target ``UserItem``
+    object as a dictionary keyed by content type (e.g. ``"workbooks"``,
+    ``"views"``, ``"datasources"``, ``"flows"``, ``"projects"``, ``"metrics"``,
+    ``"collections"``), where each value is a list of the corresponding item
+    objects.
 
     REST API: https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm
     """
@@ -77,7 +78,7 @@ def add_favorite(self, user_item: UserItem, content_type: str, item: TableauItem
         etc.) exist for each individual content type; this method is the
         polymorphic entry point.
 
-        REST API: `Add to Favorites <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm#add_workbook_to_favorites>`_
+        REST API: `Favorites Methods <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm>`_
 
         Parameters
         ----------
@@ -222,6 +223,8 @@ def add_favorite_flow(self, user_item: UserItem, flow_item: FlowItem) -> None:
     def add_favorite_metric(self, user_item: UserItem, metric_item: MetricItem) -> None:
         """Add a metric to the user's favorites.
 
+        REST API: `Add Metric to Favorites <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm#add_metric_to_favorites>`_
+
         Parameters
         ----------
         user_item : UserItem
@@ -257,6 +260,8 @@ def delete_favorite(self, user_item: UserItem, content_type: Resource, item: Tab
         ``delete_favorite_view``, etc.) exist for each individual content
         type; this method is the polymorphic entry point.
 
+        REST API: `Favorites Methods <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm>`_
+
         Parameters
         ----------
         user_item : UserItem
@@ -374,7 +379,7 @@ def delete_favorite_project(self, user_item: UserItem, project_item: ProjectItem
     def delete_favorite_flow(self, user_item: UserItem, flow_item: FlowItem) -> None:
         """Remove a flow from the user's favorites.
 
-        REST API: `Delete Flow from Favorites <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm#delete_flow_from_favorites>`_
+        REST API: `Delete Flow from Favorites <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm#ref_delete_flow_from_favorites>`_
 
         Parameters
         ----------
@@ -396,6 +401,8 @@ def delete_favorite_flow(self, user_item: UserItem, flow_item: FlowItem) -> None
     def delete_favorite_metric(self, user_item: UserItem, metric_item: MetricItem) -> None:
         """Remove a metric from the user's favorites.
 
+        REST API: `Favorites Methods <https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_favorites.htm>`_
+
         Parameters
         ----------
         user_item : UserItem