coder · sreya · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025
diff --git a/scripts/apidocgen/concat-markdown.js b/scripts/apidocgen/concat-markdown.js
@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+if (process.argv.length < 4) {
+  console.error('Usage: node concat-markdown.js <input-dir> <output-file>');
+  process.exit(1);
+}
+
+const inputDir = process.argv[2];
+const outputFile = process.argv[3];
+
+try {
+  let combinedMarkdown = '';
+
+  // Read the main README.md first
+  const readmePath = path.join(inputDir, 'README.md');
+  if (fs.existsSync(readmePath)) {
+    const readmeContent = fs.readFileSync(readmePath, 'utf8');
+    combinedMarkdown += '<!-- APIDOCGEN: BEGIN SECTION -->\n';
+    combinedMarkdown += readmeContent;
+    combinedMarkdown += '\n\n';
+  }
+
+  // Read all API files from the Apis directory
+  const apisDir = path.join(inputDir, 'Apis');
+  if (fs.existsSync(apisDir)) {
+    const apiFiles = fs.readdirSync(apisDir)
+      .filter(file => file.endsWith('.md'))
+      .sort(); // Sort alphabetically for consistent output
+
+    for (const apiFile of apiFiles) {
+      const apiPath = path.join(apisDir, apiFile);
+      const apiContent = fs.readFileSync(apiPath, 'utf8');
+
+      // Add section marker for postprocessor
+      combinedMarkdown += '<!-- APIDOCGEN: BEGIN SECTION -->\n';
+      combinedMarkdown += apiContent;
+      combinedMarkdown += '\n\n';
+    }
+  }
+
+  // Write the combined markdown file
+  fs.writeFileSync(outputFile, combinedMarkdown);
+
+  console.log(`Successfully combined markdown files into ${outputFile}`);
+  console.log(`Total size: ${Math.round(combinedMarkdown.length / 1024)}KB`);
+
+} catch (error) {
+  console.error('Error:', error.message);
+  process.exit(1);
+}
diff --git a/scripts/apidocgen/generate.sh b/scripts/apidocgen/generate.sh
@@ -19,25 +19,32 @@ log "Use temporary file: ${API_MD_TMP_FILE}"
 
 pushd "${PROJECT_ROOT}"
 go run github.com/swaggo/swag/cmd/swag@v1.8.9 init \
-	--generalInfo="coderd.go" \
-	--dir="./coderd,./codersdk,./enterprise/coderd,./enterprise/wsproxy/wsproxysdk" \
-	--output="./coderd/apidoc" \
-	--outputTypes="go,json" \
-	--parseDependency=true
+        --generalInfo="coderd.go" \
+        --dir="./coderd,./codersdk,./enterprise/coderd,./enterprise/wsproxy/wsproxysdk" \
+        --output="./coderd/apidoc" \
+        --outputTypes="go,json" \
+        --parseDependency=true
 popd
 
 pushd "${APIDOCGEN_DIR}"
 
-# Make sure that widdershins is installed correctly.
-pnpm exec -- widdershins --version
-# Render the Markdown file.
-pnpm exec -- widdershins \
-	--user_templates "./markdown-template" \
-	--search false \
-	--omitHeader true \
-	--language_tabs "shell:curl" \
-	--summary "../../coderd/apidoc/swagger.json" \
-	--outfile "${API_MD_TMP_FILE}"
+# Make sure that OpenAPI Generator is installed correctly.
+pnpm exec -- openapi-generator-cli version
+
+# Generate markdown documentation using OpenAPI Generator
+log "Generating markdown documentation with OpenAPI Generator..."
+OUTPUT_TMP_DIR=$(mktemp -d /tmp/coder-apidoc-openapi.XXXXXX)
+pnpm exec -- openapi-generator-cli generate \
+	-i "../../coderd/apidoc/swagger.json" \
+	-g markdown \
+	-o "${OUTPUT_TMP_DIR}"
+
+# Combine all markdown files into a single file
+log "Combining markdown files..."
+node concat-markdown.js "${OUTPUT_TMP_DIR}" "${API_MD_TMP_FILE}"
+
+# Clean up temporary directory
+rm -rf "${OUTPUT_TMP_DIR}"
 # Perform the postprocessing
 go run postprocess/main.go -in-md-file-single "${API_MD_TMP_FILE}"
 popd
diff --git a/scripts/apidocgen/openapitools.json b/scripts/apidocgen/openapitools.json
@@ -0,0 +1,7 @@
+{
+  "$schema": "./node_modules/@openapitools/openapi-generator-cli/config.schema.json",
+  "spaces": 2,
+  "generator-cli": {
+    "version": "7.14.0"
+  }
+}
diff --git a/scripts/apidocgen/package.json b/scripts/apidocgen/package.json
@@ -1,6 +1,6 @@
 {
 	"dependencies": {
-		"widdershins": "^4.0.1"
+		"@openapitools/openapi-generator-cli": "^2.15.0"
 	},
 	"resolutions": {
 		"semver": "7.5.3",