From 7add90dceb0573c3a96e476fdb611d6faf18007f Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Fri, 23 Jun 2023 11:49:37 -0700
Subject: [PATCH] Mark initial set of HTTP semantic conventions as frozen
 (#105)

---
 CHANGELOG.md                                     |  2 ++
 .../metrics/semantic_conventions/http-metrics.md | 16 +++++++++++++++-
 specification/trace/semantic_conventions/http.md |  2 +-
 3 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a63a74d990..345cdff881 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -94,3 +94,5 @@ release.
   ([#17](https://github.com/open-telemetry/opentelemetry-specification/pull/17))
 - Mark service.version as stable.
   ([#106](https://github.com/open-telemetry/semantic-conventions/pull/106))
+- Mark initial set of HTTP semantic conventions as frozen
+  ([#105](https://github.com/open-telemetry/semantic-conventions/pull/105))  
diff --git a/specification/metrics/semantic_conventions/http-metrics.md b/specification/metrics/semantic_conventions/http-metrics.md
index 7d2e2065c6..6cee733125 100644
--- a/specification/metrics/semantic_conventions/http-metrics.md
+++ b/specification/metrics/semantic_conventions/http-metrics.md
@@ -4,7 +4,7 @@ linkTitle: HTTP
 
 # Semantic Conventions for HTTP Metrics
 
-**Status**: [Experimental][DocumentStatus]
+**Status**: [Experimental, partial feature-freeze][DocumentStatus]
 
 The conventions described in this section are HTTP specific. When HTTP operations occur,
 metric events about those operations will be generated and reported to provide insight into the
@@ -55,6 +55,8 @@ operations. By adding HTTP attributes to metric events it allows for finely tune
 
 ### Metric: `http.server.duration`
 
+**Status**: [Experimental, Feature-freeze][DocumentStatus]
+
 This metric is required.
 
 When this metric is reported alongside an HTTP server span, the metric value SHOULD be the same as the HTTP server span duration.
@@ -137,6 +139,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi
 
 ### Metric: `http.server.active_requests`
 
+**Status**: [Experimental][DocumentStatus]
+
 This metric is optional.
 
 <!-- semconv metric.http.server.active_requests(metric_table) -->
@@ -204,6 +208,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi
 
 ### Metric: `http.server.request.size`
 
+**Status**: [Experimental][DocumentStatus]
+
 This metric is optional.
 
 <!-- semconv metric.http.server.request.size(metric_table) -->
@@ -280,6 +286,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi
 
 ### Metric: `http.server.response.size`
 
+**Status**: [Experimental][DocumentStatus]
+
 This metric is optional.
 
 <!-- semconv metric.http.server.response.size(metric_table) -->
@@ -358,6 +366,8 @@ SHOULD NOT be set if only IP address is available and capturing name would requi
 
 ### Metric: `http.client.duration`
 
+**Status**: [Experimental, Feature-freeze][DocumentStatus]
+
 This metric is required.
 
 When this metric is reported alongside an HTTP client span, the metric value SHOULD be the same as the HTTP client span duration.
@@ -431,6 +441,8 @@ SHOULD NOT be set if capturing it would require an extra DNS lookup.
 
 ### Metric: `http.client.request.size`
 
+**Status**: [Experimental][DocumentStatus]
+
 This metric is optional.
 
 <!-- semconv metric.http.client.request.size(metric_table) -->
@@ -498,6 +510,8 @@ SHOULD NOT be set if capturing it would require an extra DNS lookup.
 
 ### Metric: `http.client.response.size`
 
+**Status**: [Experimental][DocumentStatus]
+
 This metric is optional.
 
 <!-- semconv metric.http.client.response.size(metric_table) -->
diff --git a/specification/trace/semantic_conventions/http.md b/specification/trace/semantic_conventions/http.md
index 4b25d6650c..64e57ca3cb 100644
--- a/specification/trace/semantic_conventions/http.md
+++ b/specification/trace/semantic_conventions/http.md
@@ -1,6 +1,6 @@
 # Semantic conventions for HTTP spans
 
-**Status**: [Experimental][DocumentStatus]
+**Status**: [Experimental, Feature-freeze][DocumentStatus]
 
 This document defines semantic conventions for HTTP client and server Spans.
 They can be used for http and https schemes