[chore] move opentracing to the registry (#900)

Co-authored-by: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com>
Co-authored-by: Liudmila Molkova <limolkova@microsoft.com>

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -49,6 +49,7 @@ body:
         - area:messaging
         - area:network
         - area:oci
+        - area:opentracing
         - area:os
         - area:otel
         - area:peer

.github/ISSUE_TEMPLATE/change_proposal.yaml

@@ -42,6 +42,7 @@ body:
         - area:messaging
         - area:network
         - area:oci
+        - area:opentracing
         - area:os
         - area:otel
         - area:peer

.github/ISSUE_TEMPLATE/new-conventions.yaml

@@ -51,6 +51,7 @@ body:
         - area:messaging
         - area:network
         - area:oci
+        - area:opentracing
         - area:os
         - area:otel
         - area:peer

docs/attributes-registry/README.md

@@ -57,6 +57,7 @@ Currently, the following namespaces exist:
 * [Network](network.md)
 * [OCI](oci.md)
 * [OpenTelemetry](otel.md)
+* [OpenTracing](opentracing.md)
 * [OS](os.md)
 * [Peer](peer.md)
 * [Process](process.md)

docs/attributes-registry/opentracing.md

@@ -0,0 +1,21 @@
+<!--- Hugo front matter used to generate the website version of this page:
+--->
+
+# OpenTracing
+
+## OpenTracing Attributes
+
+<!-- semconv registry.opentracing(omit_requirement_level) -->
+| Attribute  | Type | Description  | Examples  | Stability |
+|---|---|---|---|---|
+| `opentracing.ref_type` | string | Parent-child Reference type [1] | `child_of` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+
+**[1]:** The causal relationship between a child Span and a parent Span.
+
+`opentracing.ref_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value  | Description | Stability |
+|---|---|---|
+| `child_of` | The parent Span depends on the child Span in some capacity | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `follows_from` | The parent Span doesn't depend in any way on the result of the child Span | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+<!-- endsemconv -->

docs/general/trace-compatibility.md

@@ -24,14 +24,14 @@ with one of the accepted values, describing the direct causal relationships
 between a child Span and a parent Span, as defined by
 [OpenTracing](https://github.com/opentracing/specification/blob/master/specification.md).
 
-<!-- semconv opentracing -->
+<!-- semconv opentracing(full) -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `opentracing.ref_type` | string | Parent-child Reference type [1] | `child_of` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`opentracing.ref_type`](../attributes-registry/opentracing.md) | string | Parent-child Reference type [1] | `child_of` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 
 **[1]:** The causal relationship between a child Span and a parent Span.
 
-`opentracing.ref_type` MUST be one of the following:
+`opentracing.ref_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
 
 | Value  | Description | Stability |
 |---|---|---|

model/registry/opentracing.yaml

@@ -0,0 +1,22 @@
+groups:
+  - id: registry.opentracing
+    prefix: opentracing
+    type: attribute_group
+    brief: Attributes used by the OpenTracing Shim layer.
+    attributes:
+      - id: ref_type
+        brief: 'Parent-child Reference type'
+        stability: experimental
+        note: >
+            The causal relationship between a child Span and a parent Span.
+        type:
+          allow_custom_values: true
+          members:
+            - id: child_of
+              value: 'child_of'
+              brief: "The parent Span depends on the child Span in some capacity"
+              stability: experimental
+            - id: follows_from
+              value: 'follows_from'
+              brief: "The parent Span doesn't depend in any way on the result of the child Span"
+              stability: experimental

model/trace/compatibility.yaml

@@ -1,24 +1,9 @@
 groups:
   - id: opentracing
-    prefix: opentracing
     type: span
     brief: 'This document defines semantic conventions for the OpenTracing Shim'
     note: >
         These conventions are used by the OpenTracing Shim layer.
     attributes:
-      - id: ref_type
-        brief: 'Parent-child Reference type'
-        stability: experimental
-        note: >
-            The causal relationship between a child Span and a parent Span.
-        type:
-          allow_custom_values: false
-          members:
-            - id: child_of
-              value: 'child_of'
-              brief: "The parent Span depends on the child Span in some capacity"
-              stability: experimental
-            - id: follows_from
-              value: 'follows_from'
-              brief: "The parent Span doesn't depend in any way on the result of the child Span"
-              stability: experimental
+      - ref: opentracing.ref_type
+        requirement_level: recommended