fix(dashboards): Deprecate discover in docs (#84979)

`discover` is deprecated, so we should get rid of it in our examples and
API docs for the Discover Saved Query API.

Closes #12618

Author: narsaynorath

src/sentry/apidocs/examples/dashboard_examples.py

@@ -61,7 +61,7 @@
                 }
             ],
             "limit": None,
-            "widgetType": "discover",
+            "widgetType": "transaction-like",
             "layout": {"w": 2, "y": 0, "h": 2, "minH": 2, "x": 0},
         }
     ],

src/sentry/apidocs/examples/discover_saved_query_examples.py

@@ -5,7 +5,7 @@
     "name": "Transactions by Volume",
     "projects": [],
     "version": 2,
-    "queryDataset": "discover",
+    "queryDataset": "transaction-like",
     "datasetSource": "unknown",
     "expired": False,
     "dateCreated": "2024-07-25T19:35:38.422859Z",
@@ -93,7 +93,7 @@
         "name": "All Events",
         "projects": [],
         "version": 2,
-        "queryDataset": "discover",
+        "queryDataset": "transaction-like",
         "datasetSource": "unknown",
         "expired": False,
         "dateCreated": "2024-07-25T19:35:38.422859Z",

src/sentry/discover/endpoints/serializers.py

@@ -40,10 +40,7 @@ class DiscoverSavedQuerySerializer(serializers.Serializer):
     queryDataset = serializers.ChoiceField(
         choices=DiscoverSavedQueryTypes.as_text_choices(),
         default=DiscoverSavedQueryTypes.get_type_name(DiscoverSavedQueryTypes.ERROR_EVENTS),
-        help_text="""The dataset you would like to query. Allowed values are:
-- error-events
-- transaction-like
-""",
+        help_text="The dataset you would like to query. Note: `discover` is a **deprecated** value. The allowed values are: `error-events`, `transaction-like`",
     )
     start = serializers.DateTimeField(
         required=False, allow_null=True, help_text="The saved start time for this saved query."