Fixed doc strings of SPANDATA (#2084)

Author: antonpirker

sentry_sdk/consts.py

@@ -51,31 +51,43 @@ class INSTRUMENTER:
     OTEL = "otel"
 
 
-# See: https://develop.sentry.dev/sdk/performance/span-data-conventions/
 class SPANDATA:
-    # An identifier for the database management system (DBMS) product being used.
-    # See: https://github.com/open-telemetry/opentelemetry-python/blob/e00306206ea25cf8549eca289e39e0b6ba2fa560/opentelemetry-semantic-conventions/src/opentelemetry/semconv/trace/__init__.py#L58
+    """
+    Additional information describing the type of the span.
+    See: https://develop.sentry.dev/sdk/performance/span-data-conventions/
+    """
+
     DB_SYSTEM = "db.system"
+    """
+    An identifier for the database management system (DBMS) product being used.
+    See: https://github.com/open-telemetry/opentelemetry-specification/blob/24de67b3827a4e3ab2515cd8ab62d5bcf837c586/specification/trace/semantic_conventions/database.md
+    Example: postgresql
+    """
 
-    # A boolean indicating whether the requested data was found in the cache.
     CACHE_HIT = "cache.hit"
+    """
+    A boolean indicating whether the requested data was found in the cache.
+    Example: true
+    """
 
-    # The size of the requested data in bytes.
     CACHE_ITEM_SIZE = "cache.item_size"
     """
-    An identifier for the database management system (DBMS) product being used.
-    See: https://github.com/open-telemetry/opentelemetry-python/blob/e00306206ea25cf8549eca289e39e0b6ba2fa560/opentelemetry-semantic-conventions/src/opentelemetry/semconv/trace/__init__.py#L58
+    The size of the requested data in bytes.
+    Example: 58
     """
+
     HTTP_QUERY = "http.query"
     """
     The Query string present in the URL.
     Example: ?foo=bar&bar=baz
     """
+
     HTTP_FRAGMENT = "http.fragment"
     """
     The Fragments present in the URL.
     Example: #foo=bar
     """
+
     HTTP_METHOD = "http.method"
     """
     The HTTP method used.