feat(llms): LLM-friendly Markdown, ChatGPT and Claude links.

This enables LLM-friendly documentation for entire sections,
allowing users to copy complete documentation sections with a single click.

Lambda@Edge now generates .md files on-demand with:
- Evaluated Hugo shortcodes
- Proper YAML frontmatter with product metadata
- Clean markdown without UI elements
- Section aggregation (parent + children in single file)

The llms.txt files are now generated automatically during build from
content structure and product metadata in data/products.yml, eliminating
the need for hardcoded files and ensuring maintainability.

**Testing**:
- Automated markdown generation in test setup via cy.exec()
- Implement dynamic content validation that extracts HTML content and
  verifies it appears in markdown version

**Documentation**:
Documents LLM-friendly markdown generation

**Details**:
Add gzip decompression for S3 HTML files in Lambda markdown generator

HTML files stored in S3 are gzip-compressed but the Lambda was attempting
to parse compressed data as UTF-8, causing JSDOM to fail to find article
elements. This resulted in 404 errors for .md and .section.md requests.

- Add zlib gunzip decompression in s3-utils.js fetchHtmlFromS3()
- Detect gzip via ContentEncoding header or magic bytes (0x1f 0x8b)
- Add configurable DEBUG constant for verbose logging
- Add debug logging for buffer sizes and decompression in both files

The decompression adds ~1-5ms per request but is necessary to parse
HTML correctly. CloudFront caching minimizes Lambda invocations.

Await async markdown conversion functions

The convertToMarkdown and convertSectionToMarkdown functions are async
but weren't being awaited, causing the Lambda to return a Promise object
instead of a string. This resulted in CloudFront validation errors:
"The body is not a string, is not an object, or exceeds the maximum size"

**Troubleshooting**:

- Set DEBUG for troubleshooting in lambda

Author: sanderson

.circleci/config.yml

@@ -42,6 +42,9 @@ jobs:
       - run:
           name: Hugo Build
           command: yarn hugo --environment production --logLevel info --gc --destination workspace/public
+      - run:
+          name: Generate LLM-friendly Markdown
+          command: node scripts/html-to-markdown.js
       - persist_to_workspace:
           root: workspace
           paths:

.claude/settings.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./secrets/**)",
+      "Read(./config/credentials.json)",
+      "Read(./build)"
+    ],
+    "ask": [
+      "Bash(git push:*)"
+    ]
+  }
+}

.gitignore

@@ -38,10 +38,25 @@ tmp
 
 # TypeScript build output
 **/dist/
+**/dist-lambda/
 
 # User context files for AI assistant tools
 .context/*
 !.context/README.md
 
 # External repos
 .ext/*
+
+# Lambda deployment artifacts
+deploy/llm-markdown/lambda-edge/markdown-generator/*.zip
+deploy/llm-markdown/lambda-edge/markdown-generator/package-lock.json
+deploy/llm-markdown/lambda-edge/markdown-generator/.package-tmp/
+deploy/llm-markdown/lambda-edge/markdown-generator/yarn.lock
+deploy/llm-markdown/lambda-edge/markdown-generator/config.json
+
+# JavaScript/TypeScript build artifacts
+*.tsbuildinfo
+*.d.ts
+*.d.ts.map
+*.js.map
+.eslintcache

.s3deploy.yml

@@ -4,5 +4,5 @@ routes:
       headers:
          Cache-Control: "max-age=630720000, no-transform, public"
       gzip: true
-    - route: "^.+\\.(html|xml|json|js)$"
+    - route: "^.+\\.(html|xml|json|js|md)$"
       gzip: true

DOCS-DEPLOYING.md

@@ -0,0 +1,85 @@
+# Deploying InfluxData documentation
+
+## Lambda\@Edge Markdown Generator
+
+docs.influxdata.com uses a Lambda\@Edge function for on-demand markdown generation from HTML documentation. The generated markdown files are optimized for LLMs, coding assistants, and agents.
+
+### Architecture
+
+```
+User Request (*.md)
+    ↓
+CloudFront Distribution
+    ↓
+Lambda@Edge (Origin Request)
+    ↓
+Fetch HTML from S3
+    ↓
+Convert to Markdown (using shared library)
+    ↓
+Return to CloudFront (cached 1hr)
+    ↓
+User receives Markdown
+```
+
+### Repository Structure
+
+All markdown generation code is in this repository:
+
+```
+docs-v2/
+├── scripts/
+│   ├── lib/markdown-converter.js      # Shared conversion library
+│   └── html-to-markdown.js            # Local CLI for testing
+├── deploy/
+│   └── llm-markdown/
+│       ├── README.md                   # Lambda deployment guide
+│       └── lambda-edge/
+│           └── markdown-generator/
+│               ├── index.js            # Lambda handler
+│               ├── lib/s3-utils.js    # S3 operations
+│               ├── deploy.sh          # Deployment script
+│               └── package.json       # Lambda dependencies
+└── cypress/e2e/content/
+    └── markdown-content-validation.cy.js  # Validation tests
+```
+
+### Local Development
+
+Generate markdown files locally for testing:
+
+```bash
+# Prerequisites
+yarn install
+yarn build:ts
+npx hugo --quiet
+
+# Generate markdown for specific path
+node scripts/html-to-markdown.js --path influxdb3/core/get-started --limit 10
+
+# Run validation tests
+node cypress/support/run-e2e-specs.js \
+  --spec "cypress/e2e/content/markdown-content-validation.cy.js"
+```
+
+See [DOCS-TESTING.md](DOCS-TESTING.md) for comprehensive testing documentation.
+
+### Lambda Deployment
+
+Deploy the Lambda\@Edge function to AWS:
+
+```bash
+# Navigate to Lambda directory
+cd deploy/llm-markdown/lambda-edge/markdown-generator
+
+# Install dependencies
+npm install
+
+# Deploy to staging
+./deploy.sh staging
+
+# Deploy to production
+./deploy.sh production
+```
+
+See [deploy/llm-markdown/README.md](deploy/llm-markdown/README.md) for detailed deployment instructions.