From 6004e3e661bb2930bbbf610f923ad2bbf78a13d7 Mon Sep 17 00:00:00 2001 From: Rachael Graham Date: Fri, 21 Aug 2026 16:18:08 -0500 Subject: [PATCH 01/77] Split kagent docs into versioned 0.x/1.x tree for the 1.0 rewrite MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move the existing flat kagent doc set to content/kagent/0.x/ (frozen) and add content/kagent/1.x/ for the Agent Substrate/v1alpha3 rewrite, wired up with docs-theme-extras' version switcher via sections.kagent.versions. Scope the versions to the kagent section specifically (not site-wide) since this Hugo build also serves kmcp, which stays unversioned. That also required two local overrides of upstream partials (navbar.html, version-banner.html): upstream assumes a single-product site where the version sits directly after the baseURL, which breaks kagent's actual /docs/kagent//... shape (an extra section segment) and doesn't scope by section — both fixed here after empirically verifying with a real Hugo build. Also repoints the marketing site's hardcoded doc links and the nightly update-ref-docs.yaml job at 0.x so they keep working, and fixes a stale .docs-test.toml comment left over from the removed MDX pipeline. Co-Authored-By: Claude Sonnet 5 Signed-off-by: Rachael Graham --- .github/workflows/update-ref-docs.yaml | 15 +- docs-site/.docs-test.toml | 21 +- docs-site/content/kagent/0.x/_index.md | 37 ++ .../kagent/{ => 0.x}/concepts/_index.md | 0 .../{ => 0.x}/concepts/agent-harness.md | 0 .../kagent/{ => 0.x}/concepts/agent-memory.md | 0 .../{ => 0.x}/concepts/agent-substrate.md | 0 .../kagent/{ => 0.x}/concepts/agents.md | 0 .../kagent/{ => 0.x}/concepts/architecture.md | 0 .../kagent/{ => 0.x}/concepts/mcp-apps.md | 0 .../kagent/{ => 0.x}/concepts/tools.md | 0 .../kagent/{ => 0.x}/examples/_index.md | 0 .../kagent/{ => 0.x}/examples/a2a-agents.md | 0 .../kagent/{ => 0.x}/examples/a2a-byo.md | 0 .../{ => 0.x}/examples/agent-harness.md | 0 .../{ => 0.x}/examples/agent-substrate.md | 0 .../kagent/{ => 0.x}/examples/agentgateway.md | 0 .../kagent/{ => 0.x}/examples/agents-mcp.md | 0 .../kagent/{ => 0.x}/examples/crewai-byo.md | 0 .../kagent/{ => 0.x}/examples/discord-a2a.md | 0 .../{ => 0.x}/examples/documentation.md | 0 .../{ => 0.x}/examples/human-in-the-loop.md | 0 .../{ => 0.x}/examples/langchain-byo.md | 0 .../kagent/{ => 0.x}/examples/skills.md | 0 .../kagent/{ => 0.x}/examples/slack-a2a.md | 0 .../kagent/{ => 0.x}/examples/telegram-bot.md | 0 .../{ => 0.x}/getting-started/_index.md | 0 .../{ => 0.x}/getting-started/first-agent.md | 0 .../getting-started/first-mcp-tool.md | 0 .../getting-started/local-development.md | 0 .../{ => 0.x}/getting-started/quickstart.md | 0 .../getting-started/system-prompts.md | 0 .../kagent/{ => 0.x}/introduction/_index.md | 0 .../kagent/{ => 0.x}/introduction/features.md | 0 .../{ => 0.x}/introduction/installation.md | 0 .../{ => 0.x}/introduction/what-is-kagent.md | 0 .../content/kagent/0.x/not-in-version.md | 8 + .../kagent/{ => 0.x}/observability/_index.md | 0 .../{ => 0.x}/observability/audit-prompts.md | 0 .../{ => 0.x}/observability/launch-ui.md | 0 .../kagent/{ => 0.x}/observability/tracing.md | 0 .../kagent/{ => 0.x}/operations/_index.md | 0 .../kagent/{ => 0.x}/operations/debug.md | 0 .../operations/operational-considerations.md | 0 .../kagent/{ => 0.x}/operations/uninstall.md | 0 .../kagent/{ => 0.x}/operations/upgrade.md | 0 .../kagent/{ => 0.x}/resources/_index.md | 0 .../kagent/{ => 0.x}/resources/api-ref.md | 0 .../kagent/{ => 0.x}/resources/cli/_index.md | 0 .../{ => 0.x}/resources/cli/kagent-add-mcp.md | 0 .../resources/cli/kagent-bug-report.md | 0 .../{ => 0.x}/resources/cli/kagent-build.md | 0 .../resources/cli/kagent-completion.md | 0 .../resources/cli/kagent-dashboard.md | 0 .../{ => 0.x}/resources/cli/kagent-deploy.md | 0 .../{ => 0.x}/resources/cli/kagent-get.md | 0 .../{ => 0.x}/resources/cli/kagent-help.md | 0 .../{ => 0.x}/resources/cli/kagent-init.md | 0 .../{ => 0.x}/resources/cli/kagent-install.md | 0 .../{ => 0.x}/resources/cli/kagent-invoke.md | 0 .../{ => 0.x}/resources/cli/kagent-mcp.md | 0 .../{ => 0.x}/resources/cli/kagent-run.md | 0 .../resources/cli/kagent-uninstall.md | 0 .../{ => 0.x}/resources/cli/kagent-version.md | 0 .../kagent/{ => 0.x}/resources/community.md | 0 .../content/kagent/{ => 0.x}/resources/faq.md | 0 .../kagent/{ => 0.x}/resources/helm.md | 0 .../{ => 0.x}/resources/release-notes.md | 0 .../{ => 0.x}/resources/tools-ecosystem.md | 0 .../kagent/{ => 0.x}/resources/versions.md | 0 .../{ => 0.x}/supported-providers/_index.md | 0 .../supported-providers/amazon-bedrock.md | 0 .../supported-providers/anthropic.md | 0 .../supported-providers/azure-ai-foundry.md | 0 .../supported-providers/azure-openai.md | 0 .../supported-providers/byo-agentgateway.md | 0 .../supported-providers/byo-openai.md | 0 .../{ => 0.x}/supported-providers/gemini.md | 0 .../supported-providers/google-vertexai.md | 0 .../{ => 0.x}/supported-providers/ollama.md | 0 .../{ => 0.x}/supported-providers/openai.md | 0 .../supported-providers/sap-ai-core.md | 0 .../{ => 0.x}/supported-providers/xai.md | 0 docs-site/content/kagent/1.x/_index.md | 13 + .../content/kagent/1.x/not-in-version.md | 8 + docs-site/content/kagent/_index.md | 31 +- docs-site/hugo.yaml | 24 ++ docs-site/layouts/_partials/navbar.html | 318 ++++++++++++++++++ .../layouts/partials/version-banner.html | 49 +++ src/app/page.tsx | 4 +- src/components/footer.tsx | 26 +- src/components/key-components.tsx | 2 +- 92 files changed, 499 insertions(+), 57 deletions(-) create mode 100644 docs-site/content/kagent/0.x/_index.md rename docs-site/content/kagent/{ => 0.x}/concepts/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/agent-harness.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/agent-memory.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/agent-substrate.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/agents.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/architecture.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/mcp-apps.md (100%) rename docs-site/content/kagent/{ => 0.x}/concepts/tools.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/a2a-agents.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/a2a-byo.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/agent-harness.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/agent-substrate.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/agentgateway.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/agents-mcp.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/crewai-byo.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/discord-a2a.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/documentation.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/human-in-the-loop.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/langchain-byo.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/skills.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/slack-a2a.md (100%) rename docs-site/content/kagent/{ => 0.x}/examples/telegram-bot.md (100%) rename docs-site/content/kagent/{ => 0.x}/getting-started/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/getting-started/first-agent.md (100%) rename docs-site/content/kagent/{ => 0.x}/getting-started/first-mcp-tool.md (100%) rename docs-site/content/kagent/{ => 0.x}/getting-started/local-development.md (100%) rename docs-site/content/kagent/{ => 0.x}/getting-started/quickstart.md (100%) rename docs-site/content/kagent/{ => 0.x}/getting-started/system-prompts.md (100%) rename docs-site/content/kagent/{ => 0.x}/introduction/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/introduction/features.md (100%) rename docs-site/content/kagent/{ => 0.x}/introduction/installation.md (100%) rename docs-site/content/kagent/{ => 0.x}/introduction/what-is-kagent.md (100%) create mode 100644 docs-site/content/kagent/0.x/not-in-version.md rename docs-site/content/kagent/{ => 0.x}/observability/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/observability/audit-prompts.md (100%) rename docs-site/content/kagent/{ => 0.x}/observability/launch-ui.md (100%) rename docs-site/content/kagent/{ => 0.x}/observability/tracing.md (100%) rename docs-site/content/kagent/{ => 0.x}/operations/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/operations/debug.md (100%) rename docs-site/content/kagent/{ => 0.x}/operations/operational-considerations.md (100%) rename docs-site/content/kagent/{ => 0.x}/operations/uninstall.md (100%) rename docs-site/content/kagent/{ => 0.x}/operations/upgrade.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/api-ref.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-add-mcp.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-bug-report.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-build.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-completion.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-dashboard.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-deploy.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-get.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-help.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-init.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-install.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-invoke.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-mcp.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-run.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-uninstall.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/cli/kagent-version.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/community.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/faq.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/helm.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/release-notes.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/tools-ecosystem.md (100%) rename docs-site/content/kagent/{ => 0.x}/resources/versions.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/_index.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/amazon-bedrock.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/anthropic.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/azure-ai-foundry.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/azure-openai.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/byo-agentgateway.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/byo-openai.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/gemini.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/google-vertexai.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/ollama.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/openai.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/sap-ai-core.md (100%) rename docs-site/content/kagent/{ => 0.x}/supported-providers/xai.md (100%) create mode 100644 docs-site/content/kagent/1.x/_index.md create mode 100644 docs-site/content/kagent/1.x/not-in-version.md create mode 100644 docs-site/layouts/_partials/navbar.html create mode 100644 docs-site/layouts/partials/version-banner.html diff --git a/.github/workflows/update-ref-docs.yaml b/.github/workflows/update-ref-docs.yaml index 5e4303fc..678b3b84 100644 --- a/.github/workflows/update-ref-docs.yaml +++ b/.github/workflows/update-ref-docs.yaml @@ -13,10 +13,17 @@ concurrency: # The docs are a Hugo site under docs-site/ (served at /docs). This workflow # generates the reference pages directly as Hugo markdown into docs-site/content: -# - kagent CRD API ref -> docs-site/content/kagent/resources/api-ref.md +# - kagent CRD API ref -> docs-site/content/kagent/0.x/resources/api-ref.md # - kmcp CRD API ref -> docs-site/content/kmcp/reference/api-ref.md -# - kagent Helm ref -> docs-site/content/kagent/resources/helm.md +# - kagent Helm ref -> docs-site/content/kagent/0.x/resources/helm.md # Each page uses plain Hugo YAML frontmatter (no MDX `export const metadata`). +# +# Targets the 0.x (current stable) tree only — v1alpha2, the API this job +# generates against, is what 0.x actually ships. The 1.x rewrite tracks +# v1alpha3 and gets its API/Helm reference hand-written for now (see the +# kagent 1.0 docs scope: Phase 4, blocked on the v1alpha3 schema settling); +# point a similar job at docs-site/content/kagent/1.x/resources/ once that's +# ready to automate. jobs: generate-api-docs: runs-on: ubuntu-latest @@ -27,9 +34,9 @@ jobs: # Target Hugo content paths (relative to the website checkout). env: - KAGENT_API_PAGE: docs-site/content/kagent/resources/api-ref.md + KAGENT_API_PAGE: docs-site/content/kagent/0.x/resources/api-ref.md KMCP_API_PAGE: docs-site/content/kmcp/reference/api-ref.md - HELM_PAGE: docs-site/content/kagent/resources/helm.md + HELM_PAGE: docs-site/content/kagent/0.x/resources/helm.md steps: - name: Checkout kagent repository diff --git a/docs-site/.docs-test.toml b/docs-site/.docs-test.toml index fdde7f01..84abaf8a 100644 --- a/docs-site/.docs-test.toml +++ b/docs-site/.docs-test.toml @@ -6,11 +6,10 @@ # against this file's directory (docs-site/). The harness does NOT build the # site — `hugo --config hugo.yaml` runs first and writes to builtRoot. # -# NOTE: docs-site/content is GENERATED from the Next.js MDX source under -# src/app/docs by `make gen-docs` (scripts/mdx-to-hugo.mjs --out docs-site/content). -# These checks run against the generated Hugo output, which is the right place -# to catch shortcode/rendering breaks — but a content fix must land in the MDX -# source (or the converter), not in docs-site/content, or `gen-docs` overwrites it. +# docs-site/content is hand-authored Markdown and is the source of truth (the +# former MDX source under src/app/docs and its mdx-to-hugo.mjs converter were +# removed once the one-time conversion landed — see "Remove the src/apps/docs +# directory"). Edit pages directly under docs-site/content. version = "1" name = "kagent-oss" @@ -35,10 +34,14 @@ scanRoots = [ "./content", ] -# NOTE: kagent docs are a flat, unversioned set (/
//) with no -# version segment. There is intentionally no [versioning] block — version-aware -# specs detect the absence and skip gracefully (same mechanism agentregistry's -# and ambientmesh's flat docs rely on). +# kagent docs are versioned (0.x frozen, 1.x in-progress rewrite), nested +# under /docs/kagent//... . kmcp, the other product built into this +# same Hugo site, stays flat/unversioned — see the sections.kagent.versions +# comment in hugo.yaml for why versions are scoped per-section rather than +# site-wide. +[versioning] +versionFromPath = "^/docs/kagent/(?[^/]+)/" +versions = ["0.x", "1.x"] # All checks default to enabled. No [checks] overrides are needed: kagent runs # the full default set. (The former `smoke`/`crossBrowser` toggles were removed diff --git a/docs-site/content/kagent/0.x/_index.md b/docs-site/content/kagent/0.x/_index.md new file mode 100644 index 00000000..489502ad --- /dev/null +++ b/docs-site/content/kagent/0.x/_index.md @@ -0,0 +1,37 @@ +--- +title: kagent +linkTitle: "kagent 0.x" +description: Concepts, guides, and reference docs for running declarative AI agents on Kubernetes, from install through day-two operations. +weight: 1 +author: kagent.dev +--- + +Your complete guide to the AI agent platform for Kubernetes + +## What is kagent? + +kagent is an innovative AI agent platform designed specifically for Kubernetes environments. +It empowers developers and operations teams to create intelligent, autonomous agents that can +monitor, manage, and automate complex Kubernetes workloads using the power of large language models (LLMs). + +kagent was created at [Solo.io](https://www.solo.io) in 2025 and is a [Cloud Native Computing Foundation](https://www.cncf.io) sandbox project. + +## Key Features + +- **AI-Powered Automation** - Create intelligent agents that understand natural language and can perform complex Kubernetes operations +- **Multi-Provider Support** - Works with OpenAI, Anthropic, Google Vertex AI, Azure OpenAI, Ollama, and custom models +- **Tool Integration** - Supports Model Context Protocol (MCP) tools, built-in Kubernetes tools, and custom HTTP tools +- **Agent-to-Agent Communication** - Enable sophisticated workflows through A2A (Agent-to-Agent) interactions +- **Comprehensive Observability** - Built-in tracing and monitoring to understand agent behavior and performance +- **Cloud Native** - Designed from the ground up to run natively in Kubernetes environments + +## Why Choose kagent? + +Whether you're looking to automate routine operations, implement intelligent monitoring, +or create sophisticated multi-agent workflows, kagent provides the tools and framework +to bring AI to your Kubernetes infrastructure. Start with simple automation and scale +to complex, intelligent systems that can reason about your cluster's state and make +informed decisions. + +## Explore the Documentation + diff --git a/docs-site/content/kagent/concepts/_index.md b/docs-site/content/kagent/0.x/concepts/_index.md similarity index 100% rename from docs-site/content/kagent/concepts/_index.md rename to docs-site/content/kagent/0.x/concepts/_index.md diff --git a/docs-site/content/kagent/concepts/agent-harness.md b/docs-site/content/kagent/0.x/concepts/agent-harness.md similarity index 100% rename from docs-site/content/kagent/concepts/agent-harness.md rename to docs-site/content/kagent/0.x/concepts/agent-harness.md diff --git a/docs-site/content/kagent/concepts/agent-memory.md b/docs-site/content/kagent/0.x/concepts/agent-memory.md similarity index 100% rename from docs-site/content/kagent/concepts/agent-memory.md rename to docs-site/content/kagent/0.x/concepts/agent-memory.md diff --git a/docs-site/content/kagent/concepts/agent-substrate.md b/docs-site/content/kagent/0.x/concepts/agent-substrate.md similarity index 100% rename from docs-site/content/kagent/concepts/agent-substrate.md rename to docs-site/content/kagent/0.x/concepts/agent-substrate.md diff --git a/docs-site/content/kagent/concepts/agents.md b/docs-site/content/kagent/0.x/concepts/agents.md similarity index 100% rename from docs-site/content/kagent/concepts/agents.md rename to docs-site/content/kagent/0.x/concepts/agents.md diff --git a/docs-site/content/kagent/concepts/architecture.md b/docs-site/content/kagent/0.x/concepts/architecture.md similarity index 100% rename from docs-site/content/kagent/concepts/architecture.md rename to docs-site/content/kagent/0.x/concepts/architecture.md diff --git a/docs-site/content/kagent/concepts/mcp-apps.md b/docs-site/content/kagent/0.x/concepts/mcp-apps.md similarity index 100% rename from docs-site/content/kagent/concepts/mcp-apps.md rename to docs-site/content/kagent/0.x/concepts/mcp-apps.md diff --git a/docs-site/content/kagent/concepts/tools.md b/docs-site/content/kagent/0.x/concepts/tools.md similarity index 100% rename from docs-site/content/kagent/concepts/tools.md rename to docs-site/content/kagent/0.x/concepts/tools.md diff --git a/docs-site/content/kagent/examples/_index.md b/docs-site/content/kagent/0.x/examples/_index.md similarity index 100% rename from docs-site/content/kagent/examples/_index.md rename to docs-site/content/kagent/0.x/examples/_index.md diff --git a/docs-site/content/kagent/examples/a2a-agents.md b/docs-site/content/kagent/0.x/examples/a2a-agents.md similarity index 100% rename from docs-site/content/kagent/examples/a2a-agents.md rename to docs-site/content/kagent/0.x/examples/a2a-agents.md diff --git a/docs-site/content/kagent/examples/a2a-byo.md b/docs-site/content/kagent/0.x/examples/a2a-byo.md similarity index 100% rename from docs-site/content/kagent/examples/a2a-byo.md rename to docs-site/content/kagent/0.x/examples/a2a-byo.md diff --git a/docs-site/content/kagent/examples/agent-harness.md b/docs-site/content/kagent/0.x/examples/agent-harness.md similarity index 100% rename from docs-site/content/kagent/examples/agent-harness.md rename to docs-site/content/kagent/0.x/examples/agent-harness.md diff --git a/docs-site/content/kagent/examples/agent-substrate.md b/docs-site/content/kagent/0.x/examples/agent-substrate.md similarity index 100% rename from docs-site/content/kagent/examples/agent-substrate.md rename to docs-site/content/kagent/0.x/examples/agent-substrate.md diff --git a/docs-site/content/kagent/examples/agentgateway.md b/docs-site/content/kagent/0.x/examples/agentgateway.md similarity index 100% rename from docs-site/content/kagent/examples/agentgateway.md rename to docs-site/content/kagent/0.x/examples/agentgateway.md diff --git a/docs-site/content/kagent/examples/agents-mcp.md b/docs-site/content/kagent/0.x/examples/agents-mcp.md similarity index 100% rename from docs-site/content/kagent/examples/agents-mcp.md rename to docs-site/content/kagent/0.x/examples/agents-mcp.md diff --git a/docs-site/content/kagent/examples/crewai-byo.md b/docs-site/content/kagent/0.x/examples/crewai-byo.md similarity index 100% rename from docs-site/content/kagent/examples/crewai-byo.md rename to docs-site/content/kagent/0.x/examples/crewai-byo.md diff --git a/docs-site/content/kagent/examples/discord-a2a.md b/docs-site/content/kagent/0.x/examples/discord-a2a.md similarity index 100% rename from docs-site/content/kagent/examples/discord-a2a.md rename to docs-site/content/kagent/0.x/examples/discord-a2a.md diff --git a/docs-site/content/kagent/examples/documentation.md b/docs-site/content/kagent/0.x/examples/documentation.md similarity index 100% rename from docs-site/content/kagent/examples/documentation.md rename to docs-site/content/kagent/0.x/examples/documentation.md diff --git a/docs-site/content/kagent/examples/human-in-the-loop.md b/docs-site/content/kagent/0.x/examples/human-in-the-loop.md similarity index 100% rename from docs-site/content/kagent/examples/human-in-the-loop.md rename to docs-site/content/kagent/0.x/examples/human-in-the-loop.md diff --git a/docs-site/content/kagent/examples/langchain-byo.md b/docs-site/content/kagent/0.x/examples/langchain-byo.md similarity index 100% rename from docs-site/content/kagent/examples/langchain-byo.md rename to docs-site/content/kagent/0.x/examples/langchain-byo.md diff --git a/docs-site/content/kagent/examples/skills.md b/docs-site/content/kagent/0.x/examples/skills.md similarity index 100% rename from docs-site/content/kagent/examples/skills.md rename to docs-site/content/kagent/0.x/examples/skills.md diff --git a/docs-site/content/kagent/examples/slack-a2a.md b/docs-site/content/kagent/0.x/examples/slack-a2a.md similarity index 100% rename from docs-site/content/kagent/examples/slack-a2a.md rename to docs-site/content/kagent/0.x/examples/slack-a2a.md diff --git a/docs-site/content/kagent/examples/telegram-bot.md b/docs-site/content/kagent/0.x/examples/telegram-bot.md similarity index 100% rename from docs-site/content/kagent/examples/telegram-bot.md rename to docs-site/content/kagent/0.x/examples/telegram-bot.md diff --git a/docs-site/content/kagent/getting-started/_index.md b/docs-site/content/kagent/0.x/getting-started/_index.md similarity index 100% rename from docs-site/content/kagent/getting-started/_index.md rename to docs-site/content/kagent/0.x/getting-started/_index.md diff --git a/docs-site/content/kagent/getting-started/first-agent.md b/docs-site/content/kagent/0.x/getting-started/first-agent.md similarity index 100% rename from docs-site/content/kagent/getting-started/first-agent.md rename to docs-site/content/kagent/0.x/getting-started/first-agent.md diff --git a/docs-site/content/kagent/getting-started/first-mcp-tool.md b/docs-site/content/kagent/0.x/getting-started/first-mcp-tool.md similarity index 100% rename from docs-site/content/kagent/getting-started/first-mcp-tool.md rename to docs-site/content/kagent/0.x/getting-started/first-mcp-tool.md diff --git a/docs-site/content/kagent/getting-started/local-development.md b/docs-site/content/kagent/0.x/getting-started/local-development.md similarity index 100% rename from docs-site/content/kagent/getting-started/local-development.md rename to docs-site/content/kagent/0.x/getting-started/local-development.md diff --git a/docs-site/content/kagent/getting-started/quickstart.md b/docs-site/content/kagent/0.x/getting-started/quickstart.md similarity index 100% rename from docs-site/content/kagent/getting-started/quickstart.md rename to docs-site/content/kagent/0.x/getting-started/quickstart.md diff --git a/docs-site/content/kagent/getting-started/system-prompts.md b/docs-site/content/kagent/0.x/getting-started/system-prompts.md similarity index 100% rename from docs-site/content/kagent/getting-started/system-prompts.md rename to docs-site/content/kagent/0.x/getting-started/system-prompts.md diff --git a/docs-site/content/kagent/introduction/_index.md b/docs-site/content/kagent/0.x/introduction/_index.md similarity index 100% rename from docs-site/content/kagent/introduction/_index.md rename to docs-site/content/kagent/0.x/introduction/_index.md diff --git a/docs-site/content/kagent/introduction/features.md b/docs-site/content/kagent/0.x/introduction/features.md similarity index 100% rename from docs-site/content/kagent/introduction/features.md rename to docs-site/content/kagent/0.x/introduction/features.md diff --git a/docs-site/content/kagent/introduction/installation.md b/docs-site/content/kagent/0.x/introduction/installation.md similarity index 100% rename from docs-site/content/kagent/introduction/installation.md rename to docs-site/content/kagent/0.x/introduction/installation.md diff --git a/docs-site/content/kagent/introduction/what-is-kagent.md b/docs-site/content/kagent/0.x/introduction/what-is-kagent.md similarity index 100% rename from docs-site/content/kagent/introduction/what-is-kagent.md rename to docs-site/content/kagent/0.x/introduction/what-is-kagent.md diff --git a/docs-site/content/kagent/0.x/not-in-version.md b/docs-site/content/kagent/0.x/not-in-version.md new file mode 100644 index 00000000..306e4dc5 --- /dev/null +++ b/docs-site/content/kagent/0.x/not-in-version.md @@ -0,0 +1,8 @@ +--- +title: Topic not available in this version +description: This topic isn't available in this version of the documentation. +build: + list: never +--- + +This topic doesn't exist in this version of the kagent docs. Use the version switcher above to go back to a version where it's available, or browse the [kagent docs]({{< relref "/kagent/0.x" >}}) landing page. diff --git a/docs-site/content/kagent/observability/_index.md b/docs-site/content/kagent/0.x/observability/_index.md similarity index 100% rename from docs-site/content/kagent/observability/_index.md rename to docs-site/content/kagent/0.x/observability/_index.md diff --git a/docs-site/content/kagent/observability/audit-prompts.md b/docs-site/content/kagent/0.x/observability/audit-prompts.md similarity index 100% rename from docs-site/content/kagent/observability/audit-prompts.md rename to docs-site/content/kagent/0.x/observability/audit-prompts.md diff --git a/docs-site/content/kagent/observability/launch-ui.md b/docs-site/content/kagent/0.x/observability/launch-ui.md similarity index 100% rename from docs-site/content/kagent/observability/launch-ui.md rename to docs-site/content/kagent/0.x/observability/launch-ui.md diff --git a/docs-site/content/kagent/observability/tracing.md b/docs-site/content/kagent/0.x/observability/tracing.md similarity index 100% rename from docs-site/content/kagent/observability/tracing.md rename to docs-site/content/kagent/0.x/observability/tracing.md diff --git a/docs-site/content/kagent/operations/_index.md b/docs-site/content/kagent/0.x/operations/_index.md similarity index 100% rename from docs-site/content/kagent/operations/_index.md rename to docs-site/content/kagent/0.x/operations/_index.md diff --git a/docs-site/content/kagent/operations/debug.md b/docs-site/content/kagent/0.x/operations/debug.md similarity index 100% rename from docs-site/content/kagent/operations/debug.md rename to docs-site/content/kagent/0.x/operations/debug.md diff --git a/docs-site/content/kagent/operations/operational-considerations.md b/docs-site/content/kagent/0.x/operations/operational-considerations.md similarity index 100% rename from docs-site/content/kagent/operations/operational-considerations.md rename to docs-site/content/kagent/0.x/operations/operational-considerations.md diff --git a/docs-site/content/kagent/operations/uninstall.md b/docs-site/content/kagent/0.x/operations/uninstall.md similarity index 100% rename from docs-site/content/kagent/operations/uninstall.md rename to docs-site/content/kagent/0.x/operations/uninstall.md diff --git a/docs-site/content/kagent/operations/upgrade.md b/docs-site/content/kagent/0.x/operations/upgrade.md similarity index 100% rename from docs-site/content/kagent/operations/upgrade.md rename to docs-site/content/kagent/0.x/operations/upgrade.md diff --git a/docs-site/content/kagent/resources/_index.md b/docs-site/content/kagent/0.x/resources/_index.md similarity index 100% rename from docs-site/content/kagent/resources/_index.md rename to docs-site/content/kagent/0.x/resources/_index.md diff --git a/docs-site/content/kagent/resources/api-ref.md b/docs-site/content/kagent/0.x/resources/api-ref.md similarity index 100% rename from docs-site/content/kagent/resources/api-ref.md rename to docs-site/content/kagent/0.x/resources/api-ref.md diff --git a/docs-site/content/kagent/resources/cli/_index.md b/docs-site/content/kagent/0.x/resources/cli/_index.md similarity index 100% rename from docs-site/content/kagent/resources/cli/_index.md rename to docs-site/content/kagent/0.x/resources/cli/_index.md diff --git a/docs-site/content/kagent/resources/cli/kagent-add-mcp.md b/docs-site/content/kagent/0.x/resources/cli/kagent-add-mcp.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-add-mcp.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-add-mcp.md diff --git a/docs-site/content/kagent/resources/cli/kagent-bug-report.md b/docs-site/content/kagent/0.x/resources/cli/kagent-bug-report.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-bug-report.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-bug-report.md diff --git a/docs-site/content/kagent/resources/cli/kagent-build.md b/docs-site/content/kagent/0.x/resources/cli/kagent-build.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-build.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-build.md diff --git a/docs-site/content/kagent/resources/cli/kagent-completion.md b/docs-site/content/kagent/0.x/resources/cli/kagent-completion.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-completion.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-completion.md diff --git a/docs-site/content/kagent/resources/cli/kagent-dashboard.md b/docs-site/content/kagent/0.x/resources/cli/kagent-dashboard.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-dashboard.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-dashboard.md diff --git a/docs-site/content/kagent/resources/cli/kagent-deploy.md b/docs-site/content/kagent/0.x/resources/cli/kagent-deploy.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-deploy.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-deploy.md diff --git a/docs-site/content/kagent/resources/cli/kagent-get.md b/docs-site/content/kagent/0.x/resources/cli/kagent-get.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-get.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-get.md diff --git a/docs-site/content/kagent/resources/cli/kagent-help.md b/docs-site/content/kagent/0.x/resources/cli/kagent-help.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-help.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-help.md diff --git a/docs-site/content/kagent/resources/cli/kagent-init.md b/docs-site/content/kagent/0.x/resources/cli/kagent-init.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-init.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-init.md diff --git a/docs-site/content/kagent/resources/cli/kagent-install.md b/docs-site/content/kagent/0.x/resources/cli/kagent-install.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-install.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-install.md diff --git a/docs-site/content/kagent/resources/cli/kagent-invoke.md b/docs-site/content/kagent/0.x/resources/cli/kagent-invoke.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-invoke.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-invoke.md diff --git a/docs-site/content/kagent/resources/cli/kagent-mcp.md b/docs-site/content/kagent/0.x/resources/cli/kagent-mcp.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-mcp.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-mcp.md diff --git a/docs-site/content/kagent/resources/cli/kagent-run.md b/docs-site/content/kagent/0.x/resources/cli/kagent-run.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-run.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-run.md diff --git a/docs-site/content/kagent/resources/cli/kagent-uninstall.md b/docs-site/content/kagent/0.x/resources/cli/kagent-uninstall.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-uninstall.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-uninstall.md diff --git a/docs-site/content/kagent/resources/cli/kagent-version.md b/docs-site/content/kagent/0.x/resources/cli/kagent-version.md similarity index 100% rename from docs-site/content/kagent/resources/cli/kagent-version.md rename to docs-site/content/kagent/0.x/resources/cli/kagent-version.md diff --git a/docs-site/content/kagent/resources/community.md b/docs-site/content/kagent/0.x/resources/community.md similarity index 100% rename from docs-site/content/kagent/resources/community.md rename to docs-site/content/kagent/0.x/resources/community.md diff --git a/docs-site/content/kagent/resources/faq.md b/docs-site/content/kagent/0.x/resources/faq.md similarity index 100% rename from docs-site/content/kagent/resources/faq.md rename to docs-site/content/kagent/0.x/resources/faq.md diff --git a/docs-site/content/kagent/resources/helm.md b/docs-site/content/kagent/0.x/resources/helm.md similarity index 100% rename from docs-site/content/kagent/resources/helm.md rename to docs-site/content/kagent/0.x/resources/helm.md diff --git a/docs-site/content/kagent/resources/release-notes.md b/docs-site/content/kagent/0.x/resources/release-notes.md similarity index 100% rename from docs-site/content/kagent/resources/release-notes.md rename to docs-site/content/kagent/0.x/resources/release-notes.md diff --git a/docs-site/content/kagent/resources/tools-ecosystem.md b/docs-site/content/kagent/0.x/resources/tools-ecosystem.md similarity index 100% rename from docs-site/content/kagent/resources/tools-ecosystem.md rename to docs-site/content/kagent/0.x/resources/tools-ecosystem.md diff --git a/docs-site/content/kagent/resources/versions.md b/docs-site/content/kagent/0.x/resources/versions.md similarity index 100% rename from docs-site/content/kagent/resources/versions.md rename to docs-site/content/kagent/0.x/resources/versions.md diff --git a/docs-site/content/kagent/supported-providers/_index.md b/docs-site/content/kagent/0.x/supported-providers/_index.md similarity index 100% rename from docs-site/content/kagent/supported-providers/_index.md rename to docs-site/content/kagent/0.x/supported-providers/_index.md diff --git a/docs-site/content/kagent/supported-providers/amazon-bedrock.md b/docs-site/content/kagent/0.x/supported-providers/amazon-bedrock.md similarity index 100% rename from docs-site/content/kagent/supported-providers/amazon-bedrock.md rename to docs-site/content/kagent/0.x/supported-providers/amazon-bedrock.md diff --git a/docs-site/content/kagent/supported-providers/anthropic.md b/docs-site/content/kagent/0.x/supported-providers/anthropic.md similarity index 100% rename from docs-site/content/kagent/supported-providers/anthropic.md rename to docs-site/content/kagent/0.x/supported-providers/anthropic.md diff --git a/docs-site/content/kagent/supported-providers/azure-ai-foundry.md b/docs-site/content/kagent/0.x/supported-providers/azure-ai-foundry.md similarity index 100% rename from docs-site/content/kagent/supported-providers/azure-ai-foundry.md rename to docs-site/content/kagent/0.x/supported-providers/azure-ai-foundry.md diff --git a/docs-site/content/kagent/supported-providers/azure-openai.md b/docs-site/content/kagent/0.x/supported-providers/azure-openai.md similarity index 100% rename from docs-site/content/kagent/supported-providers/azure-openai.md rename to docs-site/content/kagent/0.x/supported-providers/azure-openai.md diff --git a/docs-site/content/kagent/supported-providers/byo-agentgateway.md b/docs-site/content/kagent/0.x/supported-providers/byo-agentgateway.md similarity index 100% rename from docs-site/content/kagent/supported-providers/byo-agentgateway.md rename to docs-site/content/kagent/0.x/supported-providers/byo-agentgateway.md diff --git a/docs-site/content/kagent/supported-providers/byo-openai.md b/docs-site/content/kagent/0.x/supported-providers/byo-openai.md similarity index 100% rename from docs-site/content/kagent/supported-providers/byo-openai.md rename to docs-site/content/kagent/0.x/supported-providers/byo-openai.md diff --git a/docs-site/content/kagent/supported-providers/gemini.md b/docs-site/content/kagent/0.x/supported-providers/gemini.md similarity index 100% rename from docs-site/content/kagent/supported-providers/gemini.md rename to docs-site/content/kagent/0.x/supported-providers/gemini.md diff --git a/docs-site/content/kagent/supported-providers/google-vertexai.md b/docs-site/content/kagent/0.x/supported-providers/google-vertexai.md similarity index 100% rename from docs-site/content/kagent/supported-providers/google-vertexai.md rename to docs-site/content/kagent/0.x/supported-providers/google-vertexai.md diff --git a/docs-site/content/kagent/supported-providers/ollama.md b/docs-site/content/kagent/0.x/supported-providers/ollama.md similarity index 100% rename from docs-site/content/kagent/supported-providers/ollama.md rename to docs-site/content/kagent/0.x/supported-providers/ollama.md diff --git a/docs-site/content/kagent/supported-providers/openai.md b/docs-site/content/kagent/0.x/supported-providers/openai.md similarity index 100% rename from docs-site/content/kagent/supported-providers/openai.md rename to docs-site/content/kagent/0.x/supported-providers/openai.md diff --git a/docs-site/content/kagent/supported-providers/sap-ai-core.md b/docs-site/content/kagent/0.x/supported-providers/sap-ai-core.md similarity index 100% rename from docs-site/content/kagent/supported-providers/sap-ai-core.md rename to docs-site/content/kagent/0.x/supported-providers/sap-ai-core.md diff --git a/docs-site/content/kagent/supported-providers/xai.md b/docs-site/content/kagent/0.x/supported-providers/xai.md similarity index 100% rename from docs-site/content/kagent/supported-providers/xai.md rename to docs-site/content/kagent/0.x/supported-providers/xai.md diff --git a/docs-site/content/kagent/1.x/_index.md b/docs-site/content/kagent/1.x/_index.md new file mode 100644 index 00000000..f68c8997 --- /dev/null +++ b/docs-site/content/kagent/1.x/_index.md @@ -0,0 +1,13 @@ +--- +title: kagent 1.0 +linkTitle: "kagent 1.x (preview)" +description: Preview documentation for the kagent 1.0 release, built on Agent Substrate. +weight: 1 +author: kagent.dev +--- + +# kagent 1.0 (preview) + +kagent 1.0 moves the runtime from Kubernetes Deployments to [Agent Substrate](https://github.com/agent-substrate/substrate), introducing Harness, AgentTemplate, and AgentInstance as the new API surface. + +This section is under active development ahead of the 1.0 release. Pages here may be incomplete, and content may change without notice. See the [0.x docs]({{< relref "/kagent/0.x" >}}) for the current stable release. diff --git a/docs-site/content/kagent/1.x/not-in-version.md b/docs-site/content/kagent/1.x/not-in-version.md new file mode 100644 index 00000000..b4d3437f --- /dev/null +++ b/docs-site/content/kagent/1.x/not-in-version.md @@ -0,0 +1,8 @@ +--- +title: Topic not available in this version +description: This topic isn't available in this version of the documentation. +build: + list: never +--- + +This topic doesn't exist in this version of the kagent docs yet. Use the version switcher above to go back to a version where it's available, or browse the [kagent 1.0 (preview)]({{< relref "/kagent/1.x" >}}) landing page. diff --git a/docs-site/content/kagent/_index.md b/docs-site/content/kagent/_index.md index 1a4f7505..bc8c3517 100644 --- a/docs-site/content/kagent/_index.md +++ b/docs-site/content/kagent/_index.md @@ -3,34 +3,9 @@ title: kagent description: Concepts, guides, and reference docs for running declarative AI agents on Kubernetes, from install through day-two operations. weight: 1 author: kagent.dev +disableCards: true --- -Your complete guide to the AI agent platform for Kubernetes - -## What is kagent? - -kagent is an innovative AI agent platform designed specifically for Kubernetes environments. -It empowers developers and operations teams to create intelligent, autonomous agents that can -monitor, manage, and automate complex Kubernetes workloads using the power of large language models (LLMs). - -kagent was created at [Solo.io](https://www.solo.io) in 2025 and is a [Cloud Native Computing Foundation](https://www.cncf.io) sandbox project. - -## Key Features - -- **AI-Powered Automation** - Create intelligent agents that understand natural language and can perform complex Kubernetes operations -- **Multi-Provider Support** - Works with OpenAI, Anthropic, Google Vertex AI, Azure OpenAI, Ollama, and custom models -- **Tool Integration** - Supports Model Context Protocol (MCP) tools, built-in Kubernetes tools, and custom HTTP tools -- **Agent-to-Agent Communication** - Enable sophisticated workflows through A2A (Agent-to-Agent) interactions -- **Comprehensive Observability** - Built-in tracing and monitoring to understand agent behavior and performance -- **Cloud Native** - Designed from the ground up to run natively in Kubernetes environments - -## Why Choose kagent? - -Whether you're looking to automate routine operations, implement intelligent monitoring, -or create sophisticated multi-agent workflows, kagent provides the tools and framework -to bring AI to your Kubernetes infrastructure. Start with simple automation and scale -to complex, intelligent systems that can reason about your cluster's state and make -informed decisions. - -## Explore the Documentation +# kagent docs +{{< version-cards desc="Select a version of the kagent docs." >}} diff --git a/docs-site/hugo.yaml b/docs-site/hugo.yaml index fa93f101..7b2114e2 100644 --- a/docs-site/hugo.yaml +++ b/docs-site/hugo.yaml @@ -108,6 +108,30 @@ params: # Auto-render the light/dark toggle in the navbar displayToggle: true + # Per-section version lists, consumed by the local navbar.html override + # (layouts/_partials/navbar.html) and by docs-theme-extras' version-cards + # shortcode. Scoped under sections.kagent rather than the top-level + # `versions` key so kmcp — the other product built into this same Hugo + # site — never picks up kagent's version dropdown. See the navbar.html + # override's header comment for why that scoping is necessary here. + # + # 0.x is the frozen pre-1.0 doc set (moved verbatim from the former flat + # content/kagent/ tree); 1.x is the in-progress v1alpha3/Agent Substrate + # rewrite and carries an in-development banner until it's ready to become + # the default. + sections: + kagent: + versions: + - version: "0.x" + dropdown: "0.x (current)" + linkVersion: "0.x" + url: "/kagent/0.x" + - version: "1.x" + dropdown: "1.x (preview)" + linkVersion: "1.x" + url: "/kagent/1.x" + banner: "This is preview documentation for the upcoming kagent 1.0 release. It is incomplete and may change without notice." + # Top nav — mirrors kagent.dev. Docs is local; the marketing/blog sections stay # on the Next.js site, so those link out to absolute kagent.dev URLs. menu: diff --git a/docs-site/layouts/_partials/navbar.html b/docs-site/layouts/_partials/navbar.html new file mode 100644 index 00000000..bd13da2f --- /dev/null +++ b/docs-site/layouts/_partials/navbar.html @@ -0,0 +1,318 @@ +{{- /* Custom navbar override: adds version dropdown from [[params.versions]] */ -}} +{{- $navWidth := "hx:max-w-[90rem]" -}} +{{- with .Site.Params.navbar.width -}} + {{ if eq . "normal" -}} + {{ $navWidth = "hx:max-w-screen-xl" -}} + {{ else if eq . "full" -}} + {{ $navWidth = "max-w-full" -}} + {{ end -}} +{{- end -}} + +{{- $page := . -}} +{{- $iconHeight := 24 -}} + +
+
+ + +
diff --git a/docs-site/layouts/partials/version-banner.html b/docs-site/layouts/partials/version-banner.html new file mode 100644 index 00000000..be3f790f --- /dev/null +++ b/docs-site/layouts/partials/version-banner.html @@ -0,0 +1,49 @@ +{{- /* kagent override of docs-theme-extras' version-banner.html. + + Why this exists: upstream matches against `.FirstSection.RelPermalink` + (always the top-level section, e.g. "/kagent/") checked as a substring + against `.linkVersion`, which can't see a version segment nested a + level deeper (content/kagent/0.x/…) — the substring check would never + fire. It also reads only the site-wide Site.Params.versions, which + kagent leaves unset (see the navbar.html override) since this build + also serves kmcp, an unrelated, unversioned product. + + Fix: resolve versions the same way navbar.html's override and + version-cards.html do (Site.Params.sections..versions, + falling back to the site-wide list), and match by checking whether any + exact path segment of the current page's own RelPermalink equals + `.linkVersion` — correct regardless of nesting depth, folder prefix, + or language prefix, and still no-ops on kmcp pages since none of their + segments will ever equal "0.x"/"1.x". + + Everything below the resolution step (the bannerID/i18n handling, + markdownify, markup) matches upstream. */ -}} +{{- $currentSection := .Section -}} +{{- $versions := slice -}} +{{- if and $currentSection (isset .Site.Params.sections $currentSection) -}} + {{- with (index .Site.Params.sections $currentSection).versions -}} + {{- $versions = . -}} + {{- end -}} +{{- end -}} +{{- if eq (len $versions) 0 -}} + {{- with .Site.Params.versions -}} + {{- $versions = . -}} + {{- end -}} +{{- end -}} + +{{- $segments := split (strings.Trim .RelPermalink "/") "/" -}} +{{- $bannerText := "" -}} +{{- range $versions -}} + {{- if and (not $bannerText) .banner (in $segments .linkVersion) -}} + {{- $bannerText = .banner -}} + {{- if .bannerID -}} + {{- $translated := i18n .bannerID . -}} + {{- if $translated -}}{{- $bannerText = $translated -}}{{- end -}} + {{- end -}} + {{- end -}} +{{- end -}} +{{- with $bannerText }} +
+ {{ . | markdownify }} +
+{{- end -}} diff --git a/src/app/page.tsx b/src/app/page.tsx index 66289ba6..2c2aeacb 100644 --- a/src/app/page.tsx +++ b/src/app/page.tsx @@ -264,7 +264,7 @@ export default function RedesignPage() { already trusts. Open source. Production grade. Built by the founders of Istio.

- + Get Started @@ -680,7 +680,7 @@ export default function RedesignPage() {

Run your first agent on Kubernetes today.

One Helm chart. One CRD. One namespace. You'll be looking at agent traces before your coffee gets cold.

- + Get Started diff --git a/src/components/footer.tsx b/src/components/footer.tsx index d9c03ec9..1fe8874c 100644 --- a/src/components/footer.tsx +++ b/src/components/footer.tsx @@ -18,22 +18,22 @@ export default function Footer() {

Getting Started