netlify.toml

[build]
  command = "yarn build"
  publish = "build"

# Serve raw markdown companion files with the correct MIME type so AI
# crawlers and the Ask-AI button's deep links get plain text rather than
# HTML or a download prompt.
[[headers]]
  for = "/*.md"
  [headers.values]
    Content-Type = "text/markdown; charset=utf-8"
    Cache-Control = "public, max-age=300, must-revalidate"
    X-Robots-Tag = "index, follow"

# Same treatment for nested .md files (e.g. /docs/intro.md, /ai/.../foo.md).
[[headers]]
  for = "/**/*.md"
  [headers.values]
    Content-Type = "text/markdown; charset=utf-8"
    Cache-Control = "public, max-age=300, must-revalidate"
    X-Robots-Tag = "index, follow"

# llms.txt + llms-full.txt: plain text, edge-cached, robot-friendly.
[[headers]]
  for = "/llms.txt"
  [headers.values]
    Content-Type = "text/plain; charset=utf-8"
    Cache-Control = "public, max-age=300, must-revalidate"
    X-Robots-Tag = "index, follow"

[[headers]]
  for = "/llms-full.txt"
  [headers.values]
    Content-Type = "text/plain; charset=utf-8"
    Cache-Control = "public, max-age=300, must-revalidate"
    X-Robots-Tag = "index, follow"

# Query library is a separate site (query-library.stackql.io repo) proxied
# under the canonical path. 200 = proxy rewrite, URL stays on stackql.io.
# Response headers (content types, CORS, cache) are set by the origin site.
# CONTRACT: the `from` prefix here must equal `baseUrl` in the
# query-library.stackql.io repo's docusaurus.config.js (and the `to` strips
# it, so that origin serves at its root - see the comments in that repo's
# docusaurus.config.js and netlify.toml). These values must agree forever.
[[redirects]]
  from = "/docs/query-library/*"
  to = "https://query-library.stackql.io/:splat"
  status = 200
  force = true

# describe_resource was retired as an MCP tool (stackql PR #796); its page
# redirects to describe_method, the per-method source of column names.
[[redirects]]
  from = "/docs/mcp/describe_resource"
  to = "/docs/mcp/describe_method"
  status = 301