Skip to content

Add expanded AI Edge how-to guide set#32

Open
bmertens-datum wants to merge 1 commit into
mainfrom
how-to-guides/ai-edge-expanded
Open

Add expanded AI Edge how-to guide set#32
bmertens-datum wants to merge 1 commit into
mainfrom
how-to-guides/ai-edge-expanded

Conversation

@bmertens-datum

Copy link
Copy Markdown
Contributor

Summary

  • Adds 7 new AI Edge how-to guides covering HTTPProxy filters, WAF configuration, and DNS setup
  • Adds 1 new datumctl guide covering core resource workflows
  • Existing draft guides were cleaned up for consistency (style, structure, placeholder values, cross-platform coverage)

New guides

File Description
ai-edge/proxy-waf.mdx HTTPProxy and WAF capabilities reference with full feature trees
ai-edge/dns-setup.mdx DNS zone, apex ALIAS, and subdomain CNAME setup for AI Edge endpoints
ai-edge/path-routing.mdx Path-based routing using Exact and PathPrefix matches
ai-edge/host-header-override.mdx Upstream Host header rewrite via RequestHeaderModifier
ai-edge/https-redirect.mdx HTTP to HTTPS redirect via RequestRedirect filter
ai-edge/url-rewrite.mdx Path prefix stripping and full path replacement via URLRewrite
ai-edge/waf-configuration.mdx WAF attach, Observe → Enforce workflow, paranoia levels, rule exclusions
datumctl/working-with-resources.mdx Core commands, declarative model, namespace conventions

What was cleaned up in existing guides

The previous batch of guides (basic-auth, oidc-google, oidc-auth0) were used as the style baseline. New guides follow the same structure throughout:

  • MDX frontmatter (title, description) on every file
  • Windows (PowerShell) shown before macOS / Linux in every section
  • Generic placeholder values — no hardcoded project IDs, hostnames, or endpoints
  • Uniform section order: Prerequisites → Configuration Steps → Verification → Cleanup → Troubleshooting → Best Practices → Summary
  • All YAML validated against live datumctl explain output before publishing

Notes

Guides were written with Claude Code assistance. Claude helped identify a missing required type field on HTTPProxy filters (caught via schema validation) and verified all API field names against the live cluster before finalizing each guide.

Adds 8 new guides covering HTTPProxy filters, WAF configuration, DNS
setup, and datumctl resource workflows.

New guides:
- ai-edge/proxy-waf.mdx — HTTPProxy and WAF capabilities reference
- ai-edge/dns-setup.mdx — DNS zone, ALIAS, and CNAME setup for AI Edge
- ai-edge/path-routing.mdx — Path-based routing with HTTPProxy
- ai-edge/host-header-override.mdx — Host header rewrite via RequestHeaderModifier
- ai-edge/https-redirect.mdx — HTTP to HTTPS redirect via RequestRedirect
- ai-edge/url-rewrite.mdx — Path and hostname rewriting via URLRewrite
- ai-edge/waf-configuration.mdx — WAF setup, paranoia levels, enforce workflow
- datumctl/working-with-resources.mdx — Core commands, declarative model, namespaces

All guides validated against live datumctl explain output. Existing
drafts were cleaned up for style consistency, cross-platform coverage
(Windows PowerShell + macOS/Linux), generic placeholder values, and
uniform section structure (Prerequisites, Steps, Verification, Cleanup,
Troubleshooting, Summary).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Datum 🟢 Ready View Preview Jun 3, 2026, 3:49 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant