From 6c0bb1a47d9b29ffde97ff7af92dfd4a46409e31 Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Mon, 12 Jun 2023 20:40:50 -0700
Subject: [PATCH] Mark initial set of HTTP semantic conventions as frozen

---
 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 8f6cbc18d2..a9df43a437 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -78,3 +78,5 @@ release.
   ([#69](https://github.com/open-telemetry/semantic-conventions/pull/69))
 - Clarify when HTTP client spans should end.
   ([#70](https://github.com/open-telemetry/semantic-conventions/pull/70))
+- 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 41239f296c..57cc8dd2c0 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
@@ -54,6 +54,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.
@@ -107,6 +109,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) -->
@@ -145,6 +149,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) -->
@@ -192,6 +198,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) -->
@@ -241,6 +249,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.
@@ -283,6 +293,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) -->
@@ -319,6 +331,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 0e3187d6ca..01b67f89f6 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