Add comments to autogenerated content

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpanda-data/docs-extensions-and-macros",
-  "version": "4.10.4",
+  "version": "4.10.5",
   "description": "Antora extensions and macros developed for Redpanda documentation.",
   "keywords": [
     "antora",

tools/property-extractor/generate-handlebars-docs.js

@@ -144,7 +144,8 @@ function generatePropertyPartials(properties, partialsDir) {
     const selectedTemplate = type === 'topic' ? topicTemplate : propertyTemplate;
     const content = props.map(p => selectedTemplate(p)).join('\n');
     const filename = `${type}-properties.adoc`;
-    fs.writeFileSync(path.join(propertiesPartialsDir, filename), content, 'utf8');
+  const notice = '// This content is autogenerated. Do not edit manually. To override descriptions, use the doc-tools CLI with the --overrides option: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1396244485/Review+Redpanda+configuration+properties\n';
+  fs.writeFileSync(path.join(propertiesPartialsDir, filename), notice + content, 'utf8');
     console.log(`✅ Generated ${filename} (${props.length} properties)`);
     totalCount += props.length;
   });
@@ -183,7 +184,8 @@ function generateDeprecatedDocs(properties, outputDir) {
     : path.join(outputDir, 'partials', 'deprecated', 'deprecated-properties.adoc');
 
   fs.mkdirSync(path.dirname(outputPath), { recursive: true });
-  fs.writeFileSync(outputPath, output, 'utf8');
+  const notice = '// This content is autogenerated. Do not edit manually. To override descriptions, use the doc-tools CLI with the --overrides option: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1396244485/Review+Redpanda+configuration+properties\n';
+  fs.writeFileSync(outputPath, notice + output, 'utf8');
   console.log(`✅ Generated ${outputPath}`);
   return deprecatedProperties.length;
 }
@@ -211,7 +213,8 @@ function generateTopicPropertyMappings(properties, partialsDir) {
   const hbs = handlebars.compile(hbsSource);
   const rendered = hbs({ topicProperties });
   const mappingsOut = path.join(partialsDir, 'topic-property-mappings.adoc');
-  fs.writeFileSync(mappingsOut, rendered, 'utf8');
+  const notice = '// This content is autogenerated. Do not edit manually. To override descriptions, use the doc-tools CLI with the --overrides option: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1396244485/Review+Redpanda+configuration+properties\n';
+  fs.writeFileSync(mappingsOut, notice + rendered, 'utf8');
   console.log(`✅ Generated ${mappingsOut}`);
   return topicProperties.length;
 }

tools/redpanda-connect/templates/examples-partials.hbs

@@ -1,5 +1,5 @@
 {{#with examples}}
-// This content is autogenerated. Do not edit manually.
+// This content is autogenerated. Do not edit manually. To override descriptions, use the doc-tools CLI with the --overrides option: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1247543314/Generate+reference+docs+for+Redpanda+Connect
 
 == Examples