Demo findability prototypes together

config/assembler.yml

@@ -38,6 +38,7 @@ environments:
     path_prefix: docs
     feature_flags:
       SEARCH_OR_ASK_AI: true
+      NAV_V2: true
   preview:
     uri: https://docs-v3-preview.elastic.dev
     path_prefix: ${ASSEMBLER_PREVIEW_PATH_PREFIX}
@@ -46,6 +47,7 @@ environments:
       enabled: false
     feature_flags:
       SEARCH_OR_ASK_AI: true
+      NAV_V2: true
   air-gapped:
     uri: http://localhost:8080
     path_prefix: docs
@@ -71,6 +73,7 @@ shared_configuration:
 ###
 narrative:
   checkout_strategy: full
+  current: hub-pages
 
 ###
 # 'references' defines a map of `elastic/<repository_name> * <repository_config>

config/navigation.yml

@@ -17,6 +17,7 @@ toc:
   #############
   # NARRATIVE #
   #############
+  - toc: products
   - toc: get-started
   - toc: solutions
   - toc: manage-data

config/products.yml

@@ -147,6 +147,7 @@ products:
   elasticsearch:
     display: 'Elasticsearch'
     versioning: 'stack'
+    hub: 'products/elasticsearch/v9'
   elasticsearch-client:
     display: 'Elasticsearch Client'
     versioning: 'stack'
@@ -207,6 +208,7 @@ products:
   kibana:
     display: 'Kibana'
     versioning: 'stack'
+    hub: 'products/kibana/v9'
   logstash:
     display: 'Logstash'
     versioning: 'stack'

config/whats-new.yml

@@ -0,0 +1,72 @@
+###
+# Centralized "What's new" feed used by the {whats-new} directive.
+#
+# Any page can render a product's recent highlights with:
+#
+#   :::{whats-new}
+#   :product: kibana
+#   :::
+#
+# The {whats-new} directive looks the product up in this file and renders the
+# full panel (header + items). Authors only edit this file; the directive
+# stays trivial in markdown.
+#
+# An optional `id` and `badge` per product control the section anchor and the
+# small badge shown to the left of the title; default badge is "New".
+###
+
+products:
+
+  kibana:
+    title: What's new in Kibana
+    id: whats-new
+    badge: New
+    release-links:
+      - label: '9.4'
+        url: https://www.elastic.co/docs/release-notes/kibana
+      - label: Serverless
+        url: https://www.elastic.co/docs/release-notes/serverless
+    items:
+      - title: Dashboards and visualizations APIs
+        description: Programmatically create and manage dashboards and visualizations
+        link: https://www.elastic.co/docs/api/doc/kibana
+        meta: 9.4 preview
+      - title: AI agent skills
+        description: Teach AI coding agents to work with the Elastic stack
+        link: https://www.elastic.co/docs/explore-analyze/ai-features/agent-skills
+        meta: Mar 2026
+      - title: Agent Builder
+        description: Build custom AI agents that reason over your data
+        link: https://www.elastic.co/docs/explore-analyze/ai-features/elastic-agent-builder
+        meta: 9.3 GA
+      - title: Workflows
+        description: Automate tasks with Kibana actions, HTTP calls, and AI agents
+        link: https://www.elastic.co/docs/explore-analyze/workflows
+        meta: 9.3 preview
+
+  elasticsearch:
+    title: What's new in Elasticsearch
+    id: whats-new
+    badge: New
+    release-links:
+      - label: '9.4'
+        url: https://www.elastic.co/docs/release-notes/elasticsearch
+      - label: Serverless
+        url: https://www.elastic.co/docs/release-notes/serverless
+    items:
+      - title: semantic_text field type
+        description: Simplify semantic search — no pipeline setup needed, just define the field and start querying
+        link: https://www.elastic.co/docs/solutions/search/semantic-search/semantic-search-semantic-text
+        meta: 9.4 GA
+      - title: ES|QL improvements
+        description: New functions, cross-cluster support, and dense vector operations directly in ES|QL queries
+        link: https://www.elastic.co/docs/reference/query-languages/esql/esql-getting-started
+        meta: '9.4'
+      - title: Inference API expansion
+        description: Connect to external AI models (OpenAI, Cohere, Anthropic, Hugging Face, Azure, Google) for embeddings and reranking
+        link: https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put
+        meta: '9.4'
+      - title: Breaking changes in 9.x
+        description: Review removed settings, deprecated APIs, and behavioral changes before upgrading from 8.x
+        link: https://www.elastic.co/docs/release-notes/elasticsearch/breaking-changes
+        meta: Upgrade guide

docs/_docset.yml

@@ -128,6 +128,7 @@ toc:
       - file: applies-switch.md
       - file: automated_settings.md
       - file: buttons.md
+      - file: card-group.md
       - file: changelog.md
       - file: code.md
       - file: comments.md
@@ -140,15 +141,20 @@ toc:
       - file: file_inclusion.md
       - file: footnotes.md
       - file: frontmatter.md
+      - file: hero.md
+      - file: hub-pages.md
       - file: icons.md
+      - file: intro.md
       - file: images.md
       - file: kbd.md
+      - file: link-card.md
       - file: math.md
       - file: diagrams.md
       - file: lists.md
       - file: line_breaks.md
       - file: links.md
       - file: list-sub-pages.md
+      - file: on-this-page.md
       - file: passthrough.md
       - file: sidebars.md
       - file: stepper.md
@@ -159,6 +165,7 @@ toc:
       - file: tabs.md
       - file: tagged_regions.md
       - file: titles.md
+      - file: whats-new.md
   - folder: cli
     children:
       - file: index.md
@@ -232,6 +239,14 @@ toc:
   - folder: testing
     children:
       - file: index.md
+      - folder: products
+        children:
+          - folder: elasticsearch
+            children:
+              - file: v9.md
+          - folder: kibana
+            children:
+              - file: v9.md
       - file: kibana-settings-yaml-samples.md
       - file: security-settings.md
       - file: req.md

docs/syntax/card-group.md

@@ -0,0 +1,40 @@
+# Card group
+
+A section heading + a card grid container. Wraps one or more [`{link-card}`](link-card.md) directives.
+
+## Basic
+
+```markdown
+::::{card-group}
+:title: Install and administer
+:id: install
+
+:::{link-card}
+title: Self-managed
+link: /deploy/self-managed
+description: Run on your own infrastructure.
+links:
+  - { label: Docker, url: /deploy/docker }
+:::
+
+:::{link-card}
+title: Elastic Cloud Hosted
+link: /deploy/cloud
+description: Managed deployments on AWS, GCP, or Azure.
+:::
+::::
+```
+
+The outer fence uses **four** colons (`::::`) so the inner three-colon `:::` fences for the cards aren't interpreted as a closing fence. Use as many extra colons on the outer fence as you need to nest cleanly.
+
+## Options
+
+| Option | Notes |
+|---|---|
+| `:title:` | H2 heading. Optional — without it, only the grid renders. |
+| `:intro:` | Optional intro paragraph below the heading. |
+| `:id:` | Section anchor. Picked up by [`{on-this-page}`](on-this-page.md). |
+
+## Layout
+
+The grid auto-fills 1, 2, or 3 columns based on viewport width using `grid-template-columns: repeat(auto-fill, minmax(310px, 1fr))`. Card heights match within a row.

docs/syntax/hero.md

@@ -0,0 +1,60 @@
+# Hero
+
+A full-bleed hero band with a product icon, page title, description, fake search box, version dropdown, quick-action pills, and an optional release-status line. Designed for the [hub layout](hub-pages.md) but reusable on any page.
+
+All hero content is supplied via options. The directive body is not used.
+
+## Basic
+
+```markdown
+:::{hero}
+:icon: kibana
+:title: Kibana
+:description: The UI for the Elasticsearch platform.
+:version: v9 / Serverless (current)
+:::
+```
+
+The `:title:` option doubles as the page title (no body H1 needed). `:description:` supports inline markdown — links, bold, emphasis.
+
+## Options
+
+| Option | Type | Notes |
+|---|---|---|
+| `:title:` | string | **Required.** Page heading shown next to the icon. Also picked up as the document's page title. |
+| `:description:` | inline markdown | One-line summary shown below the title. Supports bold, italics, and links. |
+| `:icon:` | string | Product key. Resolves to an inline SVG via the product-icon lookup. Known keys: `elasticsearch`, `kibana`, `observability`, `security`. Unknown keys fall back to a single-letter chip. |
+| `:version:` | string | Label inside the version chip (e.g. `v9 / Serverless (current)`). |
+| `:versions:` | comma list | When set, the chip becomes a `<details>` dropdown listing other versions. Items use `Label` (greyed, "soon") or `Label=URL` (clickable). |
+| `:quick-links:` | comma list, `Label=URL` | Pill bar below the version chip. |
+| `:releases:` | inline markdown | Small status line under the pills, supports inline links and bold/italic. |
+| `:search:` | bool, default `true` | Show the placeholder search box. |
+
+## Version dropdown
+
+```markdown
+:::{hero}
+:icon: kibana
+:title: Kibana
+:description: The UI for the Elasticsearch platform.
+:version: v9 / Serverless (current)
+:versions: v8=https://www.elastic.co/docs/products/kibana/8.x,v7
+:::
+```
+
+`v8=...` is a clickable link. `v7` (no `=URL`) renders greyed out with a "soon" badge.
+
+## Quick links and releases
+
+```markdown
+:::{hero}
+:icon: elasticsearch
+:title: Elasticsearch
+:description: The distributed search and analytics engine.
+:version: v9 / Serverless (current)
+:quick-links: Install=/install,API reference=/api,Release notes=/release-notes
+:releases: Latest&#58; [Stack 9.4.1](/rn) (Mar 28, 2026) · [Serverless deployed](/srn) Apr 1, 2026
+:::
+```
+
+The `:releases:` option is inline markdown — same syntax as a single line of body markdown. Use `&#58;` for a literal colon when you don't want YAML to parse the value as a key/value pair.

docs/syntax/hub-pages.md

@@ -0,0 +1,87 @@
+---
+products:
+  - id: elasticsearch
+  - id: kibana
+---
+
+# Hub pages
+
+Hub pages are product-scoped landing pages — a 360° overview of one product across versions, deployment types, and surfaces. They're enabled by setting `layout: hub` in the page's frontmatter and composed from a small set of dedicated directives.
+
+## Enable the layout
+
+```yaml
+---
+layout: hub
+---
+```
+
+The `hub` layout drops the right-rail "On this page" TOC and the prev/next nav. The body owns the full width of the content column so directives can render full-bleed sections.
+
+## Directives
+
+| Directive | Purpose |
+|-----------|---------|
+| [`{hero}`](hero.md) | Full-bleed page hero with product icon, title, search, version dropdown, and quick-action pills. |
+| [`{on-this-page}`](on-this-page.md) | Auto-generated inline TOC linking each section anchor on the page. |
+| [`{intro}`](intro.md) | Small "getting started" callout panel with a teal accent bar. |
+| [`{whats-new}`](whats-new.md) | "What's new" panel populated from `config/whats-new.yml`. |
+| [`{card-group}`](card-group.md) | Section heading + card grid container. |
+| [`{link-card}`](link-card.md) | Rich card with title, description, primary link list, and optional aside. |
+
+## Page skeleton
+
+```markdown
+---
+layout: hub
+---
+
+:::{hero}
+:icon: kibana
+:title: Kibana
+:description: The UI for the Elasticsearch platform.
+:version: v9 / Serverless (current)
+:versions: v8,v7
+:quick-links: Install=/install,Tutorial=/tutorial
+:releases: Latest: [Stack 9.4.1](/rn) (Mar 28, 2026)
+:::
+
+:::{on-this-page}
+:::
+
+:::{intro}
+**New to Kibana?** [Take the tutorial](/tutorial) — 30 minutes, hands-on.
+:::
+
+:::{whats-new}
+:product: kibana
+:::
+
+::::{card-group}
+:title: Install and administer
+:id: install
+
+:::{link-card}
+title: Self-managed
+link: /deploy-manage/deploy/self-managed
+description: Run Kibana on your own infrastructure.
+links:
+  - { label: Docker, url: /deploy/docker }
+  - { label: Configure, url: /deploy/configure }
+:::
+::::
+```
+
+## Product badges
+
+Every regular (non-hub) page that declares one or more `products:` in its frontmatter automatically gets a clickable badge above its H1, linking to that product's hub page. The badge → hub URL mapping is set per product in [`config/products.yml`](../configure/site/products.md):
+
+```yaml
+products:
+  kibana:
+    display: 'Kibana'
+    versioning: 'stack'
+    hub: 'products/kibana/9.0'   # path slug -- relative to site root
+```
+
+When `hub:` is null, no badge renders for that product.

docs/syntax/intro.md

@@ -0,0 +1,19 @@
+# Intro callout
+
+A small white panel with a teal accent bar — used for "getting started" callouts directly under the hero.
+
+## Basic
+
+```markdown
+:::{intro}
+**New to Kibana?** [Take the tutorial](/tutorial) — a 30-minute, hands-on walk-through of Discover, dashboards, and ES|QL.
+:::
+```
+
+Body is rendered as inline markdown. Use bold, links, and emphasis freely; keep it to one or two short paragraphs.
+
+## When to use
+
+`{intro}` is the standard "front door" panel between the [`{hero}`](hero.md) and the [`{on-this-page}`](on-this-page.md) chip. It's optional — skip it when the hero already says what readers need to know next.
+
+It is **not** an admonition. For caution / note / tip-style callouts inside body content, use the existing [admonitions](admonitions.md).