fix(docs-platform): Landing page header formatting

app/_includes/landing_pages/header.md

@@ -28,6 +28,10 @@
         </div>
     {% endif %}
     {% endunless %}
+
+    {% if include.config.description %}
+    <div class="flex flex-col gap-3">{{include.config.description | liquify | markdownify }}</div>
+    {% endif %}
 {% endcapture %}
 
 {% if include.config.sub_text %}

app/_landing_pages/ai-gateway/a2a.yaml

@@ -85,18 +85,12 @@ rows:
   - header:
       type: h2
       text: "A2A traffic observability"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    {{site.ai_gateway}} records A2A protocol traffic data so you can analyze how agent-to-agent requests are processed and resolved.
-                    - Audit logs capture task IDs, JSON-RPC method calls, payloads, latencies, and errors.
-                    - OpenTelemetry spans record task state, context IDs, TTFB, SSE event counts, and response sizes.
-                    - Log plugins (File Log, HTTP Log, TCP Log, and others) consume the structured `ai.a2a` namespace emitted by the AI A2A Proxy plugin.
-  - column_count: 3
+      description: |
+        {{site.ai_gateway}} records A2A protocol traffic data so you can analyze how agent-to-agent requests are processed and resolved.
+        - Audit logs capture task IDs, JSON-RPC method calls, payloads, latencies, and errors.
+        - OpenTelemetry spans record task state, context IDs, TTFB, SSE event counts, and response sizes.
+        - Log plugins (File Log, HTTP Log, TCP Log, and others) consume the structured `ai.a2a` namespace emitted by the AI A2A Proxy plugin.
+    column_count: 3
     columns:
       - blocks:
         - type: card
@@ -147,15 +141,10 @@ rows:
   - header:
       type: h2
       text: "Govern A2A traffic"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    Use {{site.base_gateway}} plugins to control how A2A traffic flows through the gateway. Rate limiting, traffic control, and request transformation plugins work with A2A routes the same way they work with any other proxied traffic.
-  - column_count: 2
+      description: |
+        Use {{site.base_gateway}} plugins to control how A2A traffic flows through the gateway. 
+        Rate limiting, traffic control, and request transformation plugins work with A2A routes the same way they work with any other proxied traffic.         
+    column_count: 2
     columns:
       - blocks:
         - type: card

app/_landing_pages/ai-gateway/ai-clis.yaml

@@ -40,15 +40,8 @@ rows:
   - header:
       type: h3
       text: "Claude Code"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    Claude Code is Anthropic's command-line tool that delegates coding tasks to Claude AI. Route Claude Code requests through {{site.ai_gateway}} to monitor usage, control costs, and enforce rate limits across your development team.
-  - column_count: 4
+      description: "Claude Code is Anthropic's command-line tool that delegates coding tasks to Claude AI. Route Claude Code requests through {{site.ai_gateway}} to monitor usage, control costs, and enforce rate limits across your development team."
+    column_count: 4
     columns:
       - blocks:
         - type: card
@@ -125,16 +118,8 @@ rows:
   - header:
       type: h3
       text: "Codex CLI"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    Codex CLI is OpenAI's command-line tool for code generation and assistance. Proxy Codex CLI requests through {{site.ai_gateway}} to gain visibility into API usage, implement rate limiting, and centralize credential management.
-
-  - column_count: 4
+      description: "Codex CLI is OpenAI's command-line tool for code generation and assistance. Proxy Codex CLI requests through {{site.ai_gateway}} to gain visibility into API usage, implement rate limiting, and centralize credential management."
+    column_count: 4
     columns:
       - blocks:
           - type: card
@@ -146,18 +131,10 @@ rows:
                 url: /how-to/use-codex-with-ai-gateway/
                 align: end
   - header:
-        type: h3
-        text: "Qwen Code CLI"
-    columns:
-        - blocks:
-            - type: structured_text
-              config:
-                blocks:
-                  - type: text
-                    text: |
-                      Qwen Code CLI is an AI-powered coding assistant that uses OpenAI-compatible endpoints. Proxy Qwen Code CLI requests through Kong AI Gateway to gain visibility into API usage, implement rate limiting, and centralize credential management.
-
-  - column_count: 4
+      type: h3
+      text: "Qwen Code CLI"
+      description: "Qwen Code CLI is an AI-powered coding assistant that uses OpenAI-compatible endpoints. Proxy Qwen Code CLI requests through Kong AI Gateway to gain visibility into API usage, implement rate limiting, and centralize credential management."
+    column_count: 4
     columns:
         - blocks:
             - type: card
@@ -171,15 +148,8 @@ rows:
   - header:
       type: h3
       text: "Gemini CLI"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    Gemini CLI is Google's command-line tool for interacting with Gemini models. Route Gemini CLI requests through Kong AI Gateway to monitor usage, control costs, and enforce rate limits across your development team.
-  - column_count: 4
+      description: "Gemini CLI is Google's command-line tool for interacting with Gemini models. Route Gemini CLI requests through Kong AI Gateway to monitor usage, control costs, and enforce rate limits across your development team."
+    column_count: 4
     columns:
       - blocks:
           - type: card

app/_landing_pages/ai-gateway/ai-data-gov.yaml

@@ -35,15 +35,8 @@ rows:
   - header:
       type: h2
       text: "Observability"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    You can gather logs and metrics then analyze these using {{site.konnect_short_name}} or any OpenTelemetry tool.
-  - column_count: 2
+      description: "You can gather logs and metrics then analyze these using {{site.konnect_short_name}} or any OpenTelemetry tool."
+    column_count: 2
     columns:
       - blocks:
         - type: card
@@ -93,15 +86,8 @@ rows:
   - header:
       type: h2
       text: "User Safety"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    {{site.ai_gateway}} supports content safety features across providers and also includes our Prompt Guards that act on any `llm/v1/chat` or `llm/v1/completions` requests.
-  - column_count: 2
+      description: "{{site.ai_gateway}} supports content safety features across providers and also includes our Prompt Guards that act on any `llm/v1/chat` or `llm/v1/completions` requests."
+    column_count: 2
     columns:
       - blocks:
         - type: plugin
@@ -149,15 +135,8 @@ rows:
   - header:
       type: h2
       text: "Data Loss Prevention"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    You can use {{site.ai_gateway}} features to protect personally identifiable information and prevent data loss.
-  - column_count: 1
+      description: "You can use {{site.ai_gateway}} features to protect personally identifiable information and prevent data loss."
+    column_count: 1
     columns:
       - blocks:
         - type: plugin
@@ -168,15 +147,8 @@ rows:
   - header:
       type: h2
       text: "RAG Security"
-    columns:
-      - blocks:
-          - type: structured_text
-            config:
-              blocks:
-                - type: text
-                  text: |
-                    You can secure RAG pipelines by applying robust access controls.
-  - column_count: 1
+      description: "You can secure RAG pipelines by applying robust access controls."
+    column_count: 1
     columns:
       - blocks:
         - type: plugin

app/_landing_pages/custom-dashboards.yaml

@@ -22,8 +22,6 @@ rows:
       - blocks:
           - type: structured_text
             config:
-              header:
-                text: 'Overview'
               blocks:
                 - type: text
                   text: |
@@ -74,7 +72,7 @@ rows:
   - header:
       type: h2
       text: 'FAQs'
-  - columns:
+    columns:
       - blocks:
           - type: faqs
             config:

app/_landing_pages/custom-plugins.yaml

@@ -15,22 +15,16 @@ rows:
       type: h1
       text: "Custom plugins"
 
-  - columns:
-      - blocks:
-          - type: structured_text
-            config:
-              header:
-                text: "Developing custom plugins"
-              blocks:
-                - type: text
-                  text: |
-                    Kong provides a development environment for developing plugins, 
-                    including Plugin Development Kits (or PDKs), database abstractions, migrations, and more.
-
-                    Plugins consist of modules interacting with the request/response objects or
-                    streams via a PDK to implement arbitrary logic. With custom plugins, you can configure these modules to provide custom functionality to {{site.base_gateway}}.
+  - header:
+      type: h2
+      text: "Developing custom plugins"
+      description: |
+        Kong provides a development environment for developing plugins, 
+        including Plugin Development Kits (or PDKs), database abstractions, migrations, and more.
 
-  - columns:
+        Plugins consist of modules interacting with the request/response objects or
+        streams via a PDK to implement arbitrary logic. With custom plugins, you can configure these modules to provide custom functionality to {{site.base_gateway}}.
+    columns:
       - blocks:
           - type: card
             config:
@@ -98,19 +92,13 @@ rows:
                 text: See reference
                 url: "/dedicated-cloud-gateways/reference/#custom-plugins"
 
-  - columns:
-     - blocks:
-         - type: structured_text
-           config:
-             header:
-               text: "Plugin Development Kits (PDKs)"
-             blocks:
-               - type: text
-                 text:
-                   "PDKs are sets of functions that a plugin can use to facilitate interactions between plugins
-                   and the core (or other components) of Kong. Kong provides PDKs in the following languages:"
-
-  - columns:
+  - header:
+      type: h2
+      text: "Plugin Development Kits (PDKs)"
+      description: |
+        PDKs are sets of functions that a plugin can use to facilitate interactions between plugins
+        and the core (or other components) of Kong. Kong provides PDKs in the following languages:
+    columns:
     - blocks:
       - type: card
         config:

app/_landing_pages/dedicated-cloud-gateways.yaml

@@ -107,19 +107,14 @@ rows:
                   url: /dedicated-cloud-gateways/azure-peering/
                 - text: Virtual WAN (VWAN)
                   url: /dedicated-cloud-gateways/azure-virtual-wan/
-  - columns:
-      - blocks:
-        - type: structured_text
-          config:
-            header:
-              text: "Name resolution"
-            blocks:
-              - type: text
-                text: |
-                  We recommend using private name resolution for services running in the same cloud as your Dedicated Cloud Gateway. 
-                  Use private hosted zones or private DNS if your services are in the same cloud. 
-                  Use an outbound DNS resolver if your services are in an external or on-premise DNS server. 
-  - column_count: 3
+  - header:
+      type: h2
+      text: "Name resolution"
+      description: |
+        We recommend using private name resolution for services running in the same cloud as your Dedicated Cloud Gateway. 
+        Use private hosted zones or private DNS if your services are in the same cloud. 
+        Use an outbound DNS resolver if your services are in an external or on-premise DNS server. 
+    column_count: 3
     columns:
       - blocks:
           - type: card
@@ -216,7 +211,8 @@ rows:
   - header:
       type: h2
       text: "More information"
-  - columns:
+    column_count: 3
+    columns:
       - blocks:
           - type: card
             config:
@@ -247,8 +243,6 @@ rows:
               cta:
                 text: See the API
                 url: /api/konnect/cloud-gateways/v2/
-  - column_count: 3
-    columns:
       - blocks:
           - type: card
             config:

app/_landing_pages/dev-portal.yaml

@@ -168,7 +168,7 @@ rows:
   - header:
       type: h2
       text: "Developer authentication and access"
-  - columns:
+    columns:
       - blocks:
           - type: card
             config:
@@ -232,7 +232,7 @@ rows:
   - header:
       type: h2
       text: "Dev Portal integrations"
-  - column_count: 3
+    column_count: 3
     columns:
       - blocks:
           - type: card
@@ -256,7 +256,7 @@ rows:
   - header:
       type: h2
       text: "References"
-  - columns:
+    columns:
       - blocks:
           - type: card
             config:

app/_landing_pages/dev-portal/customizations/dev-portal-customizations.yaml

@@ -273,18 +273,16 @@ rows:
 
                     {:.info}
                     > Certain domain names are restricted. See [Domain name restrictions](/dev-portal/custom-domains/#domain-name-restrictions) for more information.
-  - column_count: 3
-    columns:
       - blocks:
-          - type: card
-            config:
-              title: Custom domains
-              description: |
-                Set up custom URLs for your {{site.dev_portal}}. 
-                Custom URLs require DNS setup and your portal’s default URL.
-              icon: /assets/icons/domain.svg
-              cta:
-                url: /dev-portal/custom-domains/
+        - type: card
+          config:
+            title: Custom domains
+            description: |
+              Set up custom URLs for your {{site.dev_portal}}. 
+              Custom URLs require DNS setup and your portal’s default URL.
+            icon: /assets/icons/domain.svg
+            cta:
+              url: /dev-portal/custom-domains/
 
   - header:
       text: "Frequently asked questions"

app/_landing_pages/dev-portal/self-service.yaml

@@ -224,8 +224,7 @@ rows:
   - header:
       type: h2
       text: "Learn more"
-
-  - columns:
+    columns:
       - blocks:
           - type: card
             config: