[SC] Add documentation related to latest version of software catalog (#2328)

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

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-18 14:10:11.474531",
-            "spec_repo_commit": "d1f49008"
+            "regenerated": "2024-12-18 16:21:35.283327",
+            "spec_repo_commit": "e12aeab9"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-18 14:10:11.499340",
-            "spec_repo_commit": "d1f49008"
+            "regenerated": "2024-12-18 16:21:35.297169",
+            "spec_repo_commit": "e12aeab9"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -46837,7 +46837,11 @@ tags:
     page](https://docs.datadoghq.com/account_management/org_settings/service_accounts/)
     for more information.
   name: Service Accounts
-- description: API to create, update, retrieve and delete service definitions.
+- description: 'API to create, update, retrieve and delete service definitions.
+
+    Note: Service Catalog [v3.0 schema](https://docs.datadoghq.com/service_catalog/service_definitions/v3-0/)
+    has new API endpoints documented under [Software Catalog](https://docs.datadoghq.com/api/latest/software-catalog/).
+    Use the following Service Definition endpoints for v2.2 and earlier.'
   externalDocs:
     url: https://docs.datadoghq.com/tracing/service_catalog/
   name: Service Definition

src/datadog_api_client/v2/api/service_definition_api.py

@@ -28,6 +28,7 @@
 class ServiceDefinitionApi:
     """
     API to create, update, retrieve and delete service definitions.
+    Note: Service Catalog `v3.0 schema <https://docs.datadoghq.com/service_catalog/service_definitions/v3-0/>`_ has new API endpoints documented under `Software Catalog <https://docs.datadoghq.com/api/latest/software-catalog/>`_. Use the following Service Definition endpoints for v2.2 and earlier.
     """
 
     def __init__(self, api_client=None):

tests/v2/features/service_definition.feature

@@ -1,6 +1,10 @@
 @endpoint(service-definition) @endpoint(service-definition-v2)
 Feature: Service Definition
-  API to create, update, retrieve and delete service definitions.
+  API to create, update, retrieve and delete service definitions. Note:
+  Service Catalog [v3.0 schema](https://docs.datadoghq.com/service_catalog/s
+  ervice_definitions/v3-0/) has new API endpoints documented under [Software
+  Catalog](https://docs.datadoghq.com/api/latest/software-catalog/). Use the
+  following Service Definition endpoints for v2.2 and earlier.
 
   Background:
     Given a valid "apiKeyAuth" key in the system