[cmd/configschema] deprecate configschema (open-telemetry#30190)

**Description:**
Deprecate configschema

**Link to tracking Issue:**
See open-telemetry#30187

**Documentation:**
Deprecation notice added to functions, packages and READMEs.

.chloggen/deprecate_configschema.yaml

@@ -0,0 +1,27 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: deprecation
+
+# The name of the component, or a single word describing the area of concern, (e.g. filelogreceiver)
+component: configschema
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Deprecating configschema to prefer generating documentation as part of its metadata generation with mdatagen
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [30187]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext:
+
+# If your change doesn't affect end users or the exported elements of any package,
+# you should instead start your pull request title with [chore] or use the "Skip Changelog" label.
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: []

.golangci.yml

@@ -170,3 +170,6 @@ issues:
     - text: "G402:"
       linters:
         - gosec
+    - text: "SA1019: \"github.com/open-telemetry/opentelemetry-collector-contrib/cmd/configschema"
+      linters:
+        - staticcheck

cmd/configschema/README.md

@@ -1,3 +1,6 @@
+> Deprecated: [v0.92.0] This tool is deprecated and will be removed in a future release.
+> See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
+
 # ConfigSchema API
 
 This package contains an API that can be used to introspect the configuration

cmd/configschema/cfgmetadatagen/cfgmetadatagen/README.md

@@ -1,3 +1,6 @@
+> Deprecated: [v0.92.0] This tool is deprecated and will be removed in a future release.
+> See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
+
 # Config Metadata YAML Generator (alpha)
 
 This CLI application creates a configuration metadata YAML file for each

cmd/configschema/cfgmetadatagen/cfgmetadatagen/cli.go

@@ -1,6 +1,8 @@
 // Copyright The OpenTelemetry Authors
 // SPDX-License-Identifier: Apache-2.0
 
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 package cfgmetadatagen
 
 import (
@@ -15,6 +17,8 @@ import (
 
 // GenerateFiles is the entry point for cfgmetadatagen. Component factories are
 // passed in so it can be used by other distros.
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 func GenerateFiles(factories otelcol.Factories, sourceDir string, outputDir string) error {
 	dr := configschema.NewDirResolver(sourceDir, configschema.DefaultModule)
 	writer := newMetadataFileWriter(outputDir)

cmd/configschema/cfgmetadatagen/main.go

@@ -1,6 +1,8 @@
 // Copyright The OpenTelemetry Authors
 // SPDX-License-Identifier: Apache-2.0
 
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 package main
 
 import (
@@ -14,6 +16,7 @@ import (
 )
 
 func main() {
+
 	sourceDir, outputDir := getFlags()
 	c, err := components.Components()
 	if err != nil {

cmd/configschema/comments.go

@@ -1,6 +1,8 @@
 // Copyright The OpenTelemetry Authors
 // SPDX-License-Identifier: Apache-2.0
 
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 package configschema // import "github.com/open-telemetry/opentelemetry-collector-contrib/cmd/configschema"
 
 import (

cmd/configschema/docsgen/README.md

@@ -1,3 +1,6 @@
+> Deprecated: [v0.92.0] This tool is deprecated and will be removed in a future release.
+> See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
+
 # Docsgen CLI Tool
 
 This package contains a CLI tool that generates markdown files for collector

cmd/configschema/docsgen/docsgen/cli.go

@@ -1,6 +1,8 @@
 // Copyright The OpenTelemetry Authors
 // SPDX-License-Identifier: Apache-2.0
 
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 package docsgen // import "github.com/open-telemetry/opentelemetry-collector-contrib/cmd/configschema/docsgen/docsgen"
 
 import (
@@ -23,6 +25,8 @@ const mdFileName = "config.md"
 // CLI is the entrypoint for this package's functionality. It handles command-
 // line arguments for the docsgen executable and produces config documentation
 // for the specified components.
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 func CLI(factories otelcol.Factories, dr configschema.DirResolver) {
 	tableTmpl, err := tableTemplate()
 	if err != nil {

cmd/configschema/docsgen/main.go

@@ -1,6 +1,8 @@
 // Copyright The OpenTelemetry Authors
 // SPDX-License-Identifier: Apache-2.0
 
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 package main
 
 import (

cmd/configschema/go.mod

@@ -1,3 +1,5 @@
+// Deprecated: [v0.92.0] This package is deprecated and will be removed in a future release.
+// See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/30187
 module github.com/open-telemetry/opentelemetry-collector-contrib/cmd/configschema
 
 go 1.20