Add intro section

beeme1mr · Aug 31, 2022 · 9aad9d2 · 9aad9d2
1 parent 32a5ae2
commit 9aad9d2
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/specification/trace/semantic_conventions/feature-flags.md b/specification/trace/semantic_conventions/feature-flags.md
@@ -2,9 +2,12 @@
 
 **Status**: [Experimental](../../document-status.md)
 
+This document describes how a feature flag evaluation can be represented as a span in
+OpenTelemetry. The span can be used to determine the impact a feature has on a request.
+
 **Span kind:** MUST always be `INTERNAL`.
 
-The **span name** MUST be of the format `<feature_flag.provider_name> <feature_flag.flag_key>` provided that
+The **span name** SHOULD be of the format `<feature_flag.provider_name> <feature_flag.flag_key>` provided that
 `feature_flag.provider_name` is available. If `feature_flag.provider_name` is not available, the
 span SHOULD be named `Feature Flag <feature_flag.flag_key>`.