From 454d57b720074d38d7811e302bbf0d67f1f4f36f Mon Sep 17 00:00:00 2001
From: Tyler Yahn <MrAlias@users.noreply.github.com>
Date: Wed, 31 Aug 2022 12:01:02 -0700
Subject: [PATCH] Fix sdk/instrumentation pkg docs (#3130)

---
 sdk/instrumentation/doc.go     | 24 ++++++++++++++++++++++++
 sdk/instrumentation/library.go |  7 -------
 sdk/instrumentation/scope.go   |  7 -------
 3 files changed, 24 insertions(+), 14 deletions(-)
 create mode 100644 sdk/instrumentation/doc.go

diff --git a/sdk/instrumentation/doc.go b/sdk/instrumentation/doc.go
new file mode 100644
index 00000000000..6e923acab43
--- /dev/null
+++ b/sdk/instrumentation/doc.go
@@ -0,0 +1,24 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Package instrumentation provides types to represent the code libraries that
+// provide OpenTelemetry instrumentation. These types are used in the
+// OpenTelemetry signal pipelines to identify the source of telemetry.
+//
+// See
+// https://github.com/open-telemetry/oteps/blob/d226b677d73a785523fe9b9701be13225ebc528d/text/0083-component.md
+// and
+// https://github.com/open-telemetry/oteps/blob/d226b677d73a785523fe9b9701be13225ebc528d/text/0201-scope-attributes.md
+// for more information.
+package instrumentation // import "go.opentelemetry.io/otel/sdk/instrumentation"
diff --git a/sdk/instrumentation/library.go b/sdk/instrumentation/library.go
index 246873345de..39f025a1715 100644
--- a/sdk/instrumentation/library.go
+++ b/sdk/instrumentation/library.go
@@ -12,13 +12,6 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
-/*
-Package instrumentation provides an instrumentation library structure to be
-passed to both the OpenTelemetry Tracer and Meter components.
-
-For more information see
-[this](https://github.com/open-telemetry/oteps/blob/main/text/0083-component.md).
-*/
 package instrumentation // import "go.opentelemetry.io/otel/sdk/instrumentation"
 
 // Library represents the instrumentation library.
diff --git a/sdk/instrumentation/scope.go b/sdk/instrumentation/scope.go
index 775de40e30c..09c6d93f6d0 100644
--- a/sdk/instrumentation/scope.go
+++ b/sdk/instrumentation/scope.go
@@ -12,13 +12,6 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
-/*
-Package instrumentation provides an instrumentation scope structure to be
-passed to both the OpenTelemetry Tracer and Meter components.
-
-For more information see
-[this](https://github.com/open-telemetry/oteps/blob/main/text/0083-component.md).
-*/
 package instrumentation // import "go.opentelemetry.io/otel/sdk/instrumentation"
 
 // Scope represents the instrumentation scope.