[ECT-2482] Improve documentation to redirect common events usage to V1 endpoint (#2156)

* older ubuntu precommit

* Revert "older ubuntu precommit"

This reverts commit 2a7e0c1.

* Regenerate client from commit a179b579 of spec repo

---------

Co-authored-by: Anika Maskara <[email protected]>
Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: 3 people

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-13 16:09:30.230478",
-            "spec_repo_commit": "936a5463"
+            "regenerated": "2024-12-16 18:28:02.794845",
+            "spec_repo_commit": "a179b579"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-13 16:09:30.249799",
-            "spec_repo_commit": "936a5463"
+            "regenerated": "2024-12-16 18:28:02.809467",
+            "spec_repo_commit": "a179b579"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -31987,12 +31987,10 @@ paths:
         permissions:
         - events_read
     post:
-      description: 'This endpoint allows you to post events.
-
-
-        Only events with **`change` category** are under General Availability. Refer
-        to [Change Tracking](https://docs.datadoghq.com/change_tracking) for further
-        details.'
+      description: "This endpoint allows you to post events.\n\n\u2705 **Only events
+        with the `change` category** are in General Availability. See [Change Tracking](https://docs.datadoghq.com/change_tracking)
+        for more details.\n\n\u274C For use cases involving other event categories,
+        please use the V1 endpoint."
       operationId: CreateEvent
       requestBody:
         content:

lib/datadog_api_client/v2/api/events_api.rb

@@ -35,7 +35,9 @@ def create_event(body, opts = {})
     #
     # This endpoint allows you to post events.
     #
-    # Only events with **`change` category** are under General Availability. Refer to [Change Tracking](https://docs.datadoghq.com/change_tracking) for further details.
+    # ✅ **Only events with the `change` category** are in General Availability. See [Change Tracking](https://docs.datadoghq.com/change_tracking) for more details.
+    #
+    # ❌ For use cases involving other event categories, please use the V1 endpoint.
     #
     # @param body [EventCreateRequestPayload] Event request object
     # @param opts [Hash] the optional parameters