Document logger credential token normalization

Author: Copilot

src/services/resource-publisher.ts

@@ -530,6 +530,13 @@ function isAutoGeneratedProductSubscription(
   return scope.includes('/products/');
 }
 
+/**
+ * Normalize logger credential named value placeholders to canonical NamedValue names.
+ *
+ * APIM resolves logger credential references using {{namedValueName}} tokens.
+ * If an override supplies a token with different casing, APIM may reject the PUT
+ * with a validation error. This function rewrites tokens to match artifact names.
+ */
 async function normalizeLoggerCredentialNamedValueReferences(
   json: Record<string, unknown>,
   store: IArtifactStore,
@@ -555,6 +562,9 @@ async function normalizeLoggerCredentialNamedValueReferences(
     return json;
   }
 
+  // Traverse logger credentials recursively because APIM logger credential shapes
+  // vary by logger type (strings, nested objects, and arrays). Normalize every
+  // {{named-value-token}} to the canonical artifact name when found.
   const normalizeValue = (value: unknown): unknown => {
     if (typeof value === 'string') {
       return value.replace(/\{\{\s*([^}]+?)\s*\}\}/g, (match, tokenName: string) => {