fix(otlp): removed bloated comments

Author: lucastemb

lib/datadog-agent/config-overlay-model/src/lib.rs

@@ -564,32 +564,15 @@ fn resolve_refs(value: &mut serde_yaml::Value, schema_dir: &Path) -> Result<(),
     Ok(())
 }
 
-// ─── OTel Schema Resolution ─────────────────────────────────────────────────
-//
-// The OTel Collector schemas use a different JSON Schema dialect than the Datadog schema:
-// - `$ref: <name>` resolves against the current file's `$defs` (local reference)
-// - `$ref: /config/<package>.<def_name>` loads another package's `config.schema.yaml`
-//   and resolves against its `$defs` (package-qualified reference)
-// - `allOf` merges multiple fragments into a single object
-//
-// These functions load the vendored OTel schemas from `schema/otel/`, resolve all references
-// into a flat tree, strip excluded properties (`auth`, `middlewares`), convert to the Datadog
-// schema dialect (`node_type: section` / `node_type: setting`), and patch the result into the
-// Datadog schema's `otlp_config.receiver` subtree.
-
 /// Load the Datadog schema with the OTel receiver schema patched in.
-///
-/// This loads the pristine Datadog schema (`core_schema.yaml`), loads and resolves the pristine
-/// OTel receiver schema (`otel/config.schema.yaml`), and replaces the `otlp_config.receiver`
-/// subtree in the Datadog schema with the resolved OTel subtree.
 pub fn load_composed_schema(datadog_schema: &Path, otel_schema_dir: &Path) -> Result<serde_yaml::Value, Error> {
     let mut datadog_schema = load_resolved_schema(datadog_schema)?;
     let otel_receiver = load_otel_receiver(otel_schema_dir)?;
     patch_receiver(&mut datadog_schema, otel_receiver)?;
     Ok(datadog_schema)
 }
 
-/// Load and fully resolve the OTel receiver schema into a Datadog-dialect subtree.
+/// Load and completely resolve the OTel receiver schema into a Datadog compatible subtree.
 fn load_otel_receiver(otel_dir: &Path) -> Result<serde_yaml::Value, Error> {
     let schema_path = otel_dir.join("config.schema.yaml");
     let doc = read_yaml(&schema_path)?;
@@ -634,9 +617,6 @@ fn load_otel_receiver(otel_dir: &Path) -> Result<serde_yaml::Value, Error> {
 }
 
 /// Replace the `otlp_config.receiver` subtree in the Datadog schema with the resolved OTel subtree.
-///
-/// If the Datadog schema does not have an `otlp_config.receiver` subtree (for example test schemas),
-/// this is a no-op.
 fn patch_receiver(datadog_schema: &mut serde_yaml::Value, otel_receiver: serde_yaml::Value) -> Result<(), Error> {
     let Some(otlp_config) = datadog_schema
         .get_mut("properties")
@@ -654,13 +634,6 @@ fn patch_receiver(datadog_schema: &mut serde_yaml::Value, otel_receiver: serde_y
 }
 
 /// Resolve OTel schema references into a flat tree.
-///
-/// Handles three OTel schema features:
-/// - `$ref: <name>`: local lookup in the current file's `$defs`
-/// - `$ref: /config/<package>.<def_name>`: load another package's schema file
-/// - `allOf`: merge fragments into the parent
-///
-/// Also strips `auth` and `middlewares` properties (excluded from the receiver keyspace).
 fn resolve_otel_refs(
     value: &mut serde_yaml::Value, otel_dir: &Path, current_defs: &serde_yaml::Mapping,
 ) -> Result<(), Error> {
@@ -752,11 +725,6 @@ fn resolve_otel_refs(
 }
 
 /// Resolve a single `$ref` target, returning the definition value and its source `$defs`.
-///
-/// For local refs (`$ref: protocols`), looks up `current_defs`.
-/// For package-qualified refs (`$ref: /config/`configgrpc`.server_config`), loads the
-/// corresponding vendored schema file and looks up its `$defs`.
-/// For `configopaque` refs (not vendored), returns an inline type definition.
 fn resolve_otel_ref_target(
     ref_str: &str, otel_dir: &Path, current_defs: &serde_yaml::Mapping,
 ) -> Result<(serde_yaml::Value, serde_yaml::Mapping), Error> {
@@ -816,10 +784,7 @@ fn resolve_otel_ref_target(
     }
 }
 
-/// Convert an OTel schema tree to the Datadog schema dialect.
-///
-/// Adds `node_type: section` to objects with `properties` and `node_type: setting` to leaves.
-/// Removes OTel-specific extensions (`x-optional`, `x-customType`).
+/// Convert an OTel schema tree to the Datadog compatible schema dialect.
 fn convert_to_datadog_dialect(value: &mut serde_yaml::Value) {
     let Some(map) = value.as_mapping_mut() else {
         return;