Skip to content

Audit ADP landing page and replace glossary stub for GA#13

Merged
micheleRP merged 8 commits into
mainfrom
adp-3a-reference-shell
May 6, 2026
Merged

Audit ADP landing page and replace glossary stub for GA#13
micheleRP merged 8 commits into
mainfrom
adp-3a-reference-shell

Conversation

@micheleRP
Copy link
Copy Markdown
Contributor

@micheleRP micheleRP commented May 6, 2026 •
edited
Loading

Summary

Closes the §3A R1 (adp-docs side) and §3A R2 commitments in the ADP Docs Plan, plus a sweep to remove ADP Cloud mentions following the 2026-05-06 GA descope decision.

modules/ROOT/pages/index.adoc — landing-page audit

  1. Replace the banned word "leverage" in the Use cases lead.
  2. Add a == Governance section between AI Gateway and the cross-cutting governance section, with an xref to governance:dashboard/index.adoc. Surfaces the Governance Dashboard product line that shipped in PRs docs(governance): add Governance Dashboard pages for ADP GA #5 and Update ADP docs for May 4 batch (rpk ai, Bedrock GA, governance V0) #11.
  3. Rename the cross-cutting == Enterprise governance section to == Built-in governance controls to disambiguate from the new Governance section above it.
  4. Use cases section now carries a PSD-spanning set of examples (financial operations, HR/people ops, customer experience, infrastructure operations, productivity tools). Stays deployment-agnostic; no vendor-specific examples beyond Microsoft Copilot, which the page already named.
  5. AI Gateway section adds the multi-model routing framing (different models for different tasks, single cost view).
  6. Built-in governance controls — Compliance bullet now names ISO 42001 and the EU AI Act as concrete frameworks.
  7. Refactor Next steps to bare-xref form and add a Governance bullet: 
    * xref:agents:overview.adoc[]
* xref:mcp:overview.adoc[]
* xref:ai-gateway:overview.adoc[]
* xref:governance:dashboard/index.adoc[]
* xref:observability:concepts.adoc[]

modules/reference/pages/glossary.adoc — replace stub with index

The 11-line stub was a dead xref list (anchors weren't defined on the page). Replaced with an index page that:

  • Points to the canonical Redpanda glossary on shared.
  • Surfaces 17 ADP-relevant glossterm: macros with hover tooltips.

The 10 new terms (tool, resource, declarative agent, BYOA, OAuth Provider, OAuth Client, OAuth Connection, Token Vault, spending event, Governance Dashboard) currently render as not yet defined until redpanda-data/docs#1691 merges and propagates to the preview build. Existing entries render normally.

ADP Cloud descope sweep

ADP Cloud is out of the 2026-06-15 GA. Removed remaining Cloud-specific surface area:

  • Deleted the empty modules/get-started/pages/signup.adoc stub (only contained an "Add content" TODO under a Cloud-only flag).
  • modules/ROOT/nav.adoc: dropped the signup nav entry; renamed the BYOC prereqs/quickstart link text to drop the "ADP BYOC" prefix per the descope guidance to prefer "ADP" alone in shared assets.
  • modules/get-started/pages/index.adoc: replaced the Cloud signup framing in the description with deployment-agnostic wording.
  • modules/agents/pages/quickstart.adoc: dropped the "agents are not available on ADP Cloud yet" parenthetical from the prereq list.
  • modules/ROOT/partials/availability-block.adoc: collapsed to a single :page-byoc: branch; the Cloud-only and Cloud+BYOC branches no longer apply.

The 6 pages currently tagged :page-byoc: true keep that attribute so the auto-injected "Available in: BYOC" admonition keeps rendering. Suppressing the admonition entirely is a docs-ui change tracked separately.

Companion PR

  • redpanda-data/docs#1691 — adds the 10 new term partials to modules/terms/partials/ on shared. PR #1691 must merge first for the new tooltips to resolve here.

Deliberately out of scope

  • BYOA mention in the AI agents section — hold until Workflow docs(mcp-servers): rewrite MCP Servers pages for ADP GA #4 PR opens.
  • Renaming byoc-prereqs.adoc and byoc-quickstart.adoc files — bigger filename-rename lift; defer.
  • Removing :page-byoc: true from the 6 pages that have it — would cause docs-ui to render the default "Available in: Cloud, BYOC" admonition instead of "BYOC". Coordinate with docs-ui to suppress entirely.
  • Adding glossterm:Governance Dashboard[] / glossterm:declarative agent[] to first-mention spots elsewhere in adp-docs — sequencing dependency on PR #1691; can be a follow-up.

Preview pages

Test plan

  • Local Antora build is clean for the changed files (verified — zero new errors or warnings).
  • Netlify preview shows the new Governance section between AI Gateway and Built-in governance controls.
  • Use cases section has an intro line above the bullets and lists the 5 PSD-spanning examples.
  • Next steps shows 5 bare-xref bullets.
  • Glossary index page renders the canonical glossary tree below the ADP-specific entries list.
  • After PR #1691 merges, re-trigger the preview and confirm all 10 new tooltips render correctly.
  • No "Available in: Cloud" admonitions render anywhere on the preview build.
  • No xref errors from the deleted signup.adoc (no other page links to it).

🤖 Generated with Claude Code

@micheleRP @claude
Audit ADP landing page and replace glossary stub for GA
7d4a11c 
Closes the §3A R1 (adp-docs side) and §3A R2 commitments in the master
ADP Docs Plan.

Landing page (modules/ROOT/pages/index.adoc) - 5 surgical edits:
  1. Replace banned word "leverage" in Use cases lead.
  2. Add a Governance section between AI Gateway and Enterprise
     governance, pointing to governance:dashboard/index.adoc.
  3. Use cases lead now reads "Common Redpanda ADP use cases include:"
     so the bullets get an intro line per docs-team-standards.
  4. Use cases bullets unchanged (deployment-agnostic; do not import
     PSD-derived examples while ADP Cloud descope is pending).
  5. Refactor Next steps to bare-xref form and add a Governance bullet.

Glossary index (modules/reference/pages/glossary.adoc):
  - Replace the 11-line stub xref list with an index page that points
    to the canonical Redpanda glossary on shared and surfaces 17
    ADP-relevant glossterm tooltips.
  - The 10 new terms (tool, resource, declarative agent, BYOA, OAuth
    Provider, OAuth Client, OAuth Connection, Token Vault, spending
    event, Governance Dashboard) render as "not yet defined" until the
    companion docs#shared PR merges; existing terms render normally.

Companion: redpanda-data/docs#1691 adds the 10 new term partials.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP requested a review from a team as a code owner May 6, 2026 16:31
@netlify
Copy link
Copy Markdown

netlify Bot commented May 6, 2026 •
edited
Loading

✅ Deploy Preview for redpanda-agentic-data-plane ready!

Name Link
🔨 Latest commit d9e98fa
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/69fbc1a5e0f5b900083543ed
😎 Deploy Preview https://deploy-preview-13--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

micheleRP and others added 4 commits May 6, 2026 10:38
@micheleRP @claude
Incorporate PSD framing in ADP overview
4244ef0 
Per follow-up direction, relax the no-PSD-content rule for the overview
page only and pull selective framing from the portfolio strategy docs.
Stays deployment-agnostic (Cloud descope risk pending) and keeps to
docs voice (no AI-tells, no em dashes, no rule-of-three lists).

- Use cases: replace 3 generic bullets with 5 PSD-spanning examples
  across financial operations, HR/people ops, customer experience,
  infrastructure operations, and productivity tools. Keeps generic
  system categories (HRIS, ERP) over vendor-specific lock-in.

- AI Gateway: add the multi-model routing framing (frontier model for
  analysis, smaller model for triage, single cost view) drawn from the
  Cloud strategy's "multi-model routing" differentiator.

- Enterprise governance compliance bullet: name ISO 42001 and the
  EU AI Act as concrete frameworks, drawn from the BYOC strategy's
  offensive-compliance differentiator.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP @claude
Rename Enterprise governance to Built-in governance controls
200c9a7 
Disambiguate from the new == Governance section above (which points to
the Governance Dashboard product). Built-in governance controls is
about cross-cutting principles (security, authorization, observability,
compliance) and reads as such.

No xrefs target the section anchor; safe to rename.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP @claude
Remove ADP Cloud mentions following GA descope
262c634 
ADP Cloud is out of the 2026-06-15 GA. Sweep the repo to remove the
remaining Cloud-specific surface area:

- Delete the empty modules/get-started/pages/signup.adoc stub
  (only contained an "Add content" TODO under a Cloud-only flag).
- modules/ROOT/nav.adoc: drop the signup nav entry; rename the BYOC
  prereqs/quickstart link text to drop the "ADP BYOC" prefix per the
  Cloud-descope guidance to prefer "ADP" alone in shared assets.
- modules/get-started/pages/index.adoc: replace the description's
  Cloud signup framing with deployment-agnostic wording.
- modules/agents/pages/quickstart.adoc: drop the "agents are not
  available on ADP Cloud yet" parenthetical from the prereq list.
- modules/ROOT/partials/availability-block.adoc: collapse the partial
  to a single :page-byoc: branch; the Cloud-only and Cloud+BYOC
  branches no longer apply.

The 6 pages currently tagged :page-byoc: true keep that attribute so
the auto-injected "Available in: BYOC" admonition keeps rendering;
suppressing the admonition entirely is a docs-ui change tracked
separately.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP @claude
Suppress Cloud/BYOC availability admonition via UI override
4e75fac 
The "Available in: Cloud, BYOC" / "Available in: BYOC" admonition is
injected by the docs-ui v2.14.0-adp.2 bundle's partials/article.hbs.
With ADP Cloud descoped from the 2026-06-15 GA, that block no longer
serves a purpose: BYOC is the only deployment shape, so the admonition
adds visual noise without informing the reader.

Override the bundled article.hbs locally via Antora's supplemental_files
mechanism. The override is identical to the bundled template except the
ADP availability block (lines 50-100 in the original) is removed.

Suppresses the admonition on the deploy preview build immediately. The
docs-ui repo needs the same change before the next docs-ui release for
the production build to match; tracked separately.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP mentioned this pull request May 6, 2026
Merged
4 tasks
micheleRP added a commit to redpanda-data/docs-ui that referenced this pull request May 6, 2026
@micheleRP @claude
Remove ADP availability admonition for GA descope (#378)
b78c130 
ADP Cloud is descoped from the 2026-06-15 GA. With BYOC as the only
deployment shape, the "Available in: Cloud, BYOC" / "Available in:
BYOC" admonition no longer informs the reader and adds visual noise
on every ADP page.

Drop the entire `page.attributes.adp` availability block from
src/partials/article.hbs. Other badges (beta, limited-availability,
context-switcher, BYOC/Cloud labels for non-ADP pages) keep working
unchanged.

Companion PR: redpanda-data/adp-docs#13 ships the same change locally
via Antora's supplemental_files mechanism so the deploy preview is fixed
immediately. Once a new docs-ui release tag is cut from this branch and
the adp-docs / docs-site playbooks are bumped to it, the supplemental
override in adp-docs becomes redundant and can be deleted.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
micheleRP
micheleRP commented May 6, 2026
View reviewed changes
Comment thread modules/ROOT/pages/index.adoc Outdated
micheleRP
micheleRP commented May 6, 2026
View reviewed changes
Comment thread modules/reference/pages/glossary.adoc Outdated
@micheleRP micheleRP merged commit 5aa0b36 into main May 6, 2026
5 checks passed
@micheleRP micheleRP deleted the adp-3a-reference-shell branch May 6, 2026 22:37
JakeSCahill added a commit to redpanda-data/docs-ui that referenced this pull request May 26, 2026
@JakeSCahill @claude @micheleRP
Docs site restructure v3 (#376)
02429bb 
* Add BYOC and Cloud badge styles for ADP documentation

- Add badge--byoc CSS class with blue styling for BYOC-only features
- Add badge--cloud CSS class with purple styling for Cloud features
- Define CSS variables for badge colors and backgrounds

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add availability block and enhance ADP page styling

- Add availability block showing Cloud/BYOC support on ADP pages
- Add info icon with Tippy.js tooltip explaining availability
- Add BYOC and Cloud badge CSS variables for light/dark modes
- Update article.hbs to render availability block for ADP pages
- Minor fixes to header, nav, and TOC styling

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add BYOC and Cloud feature helpers for nav badges

- Add is-byoc-feature.js helper to detect page-byoc attribute
- Add is-cloud-feature.js helper to detect page-cloud-only attribute
- These helpers enable nav badge display for ADP documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Address CodeRabbit review comments

- Fix header.css: Use --nav-text-color for navbar-end items
- Fix vars.css: Add dark mode label color overrides for BYOC/Cloud badges
- Fix article.hbs: Handle case when both byoc and cloud-only attributes are true
- Fix header-content.hbs: Remove inline color that overrides CSS hover states
- Fix doc.css: Add fallback for availability info icon color

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove ADP availability admonition for GA descope (#378)

ADP Cloud is descoped from the 2026-06-15 GA. With BYOC as the only
deployment shape, the "Available in: Cloud, BYOC" / "Available in:
BYOC" admonition no longer informs the reader and adds visual noise
on every ADP page.

Drop the entire `page.attributes.adp` availability block from
src/partials/article.hbs. Other badges (beta, limited-availability,
context-switcher, BYOC/Cloud labels for non-ADP pages) keep working
unchanged.

Companion PR: redpanda-data/adp-docs#13 ships the same change locally
via Antora's supplemental_files mechanism so the deploy preview is fixed
immediately. Once a new docs-ui release tag is cut from this branch and
the adp-docs / docs-site playbooks are bumped to it, the supplemental
override in adp-docs becomes redundant and can be deleted.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Resolve merge conflict: keep availability block for ADP pages

* Add BYOC and Cloud platform badges for ADP documentation

Adds inline status badges in the sticky header for ADP pages when
features are limited to specific platforms:
- "Only in BYOC" badge when :page-byoc-only: true is set
- "Only in Cloud" badge when :page-cloud-only: true is set

Both attributes require :adp: true (set in ADP component antora.yml).
Badges are mutually exclusive - set only one.

Also includes:
- Version dropdown alignment fix (aligns left with button)
- Removed the availability block in favor of compact inline badges

* Implement unified navigation and Data Platform hierarchy

Major UI updates for hierarchical navigation system:

Navigation System:
- Add unified navigation with bucket structure (Self-Managed → Streaming/Connect)
- New bucket-header.hbs partial with icons, titles, and per-bucket version selectors
- nav-bucket.js for expand/collapse and version selector interactions
- Bucket theming with custom CSS properties for colors

Layouts & Templates:
- component-home-v3.hbs layout for new landing page design
- data-platform.hbs layout for umbrella pages
- labs-home.hbs layout for labs directory
- Updated article.hbs to move page options to sticky header eyebrow
- Updated nav-menu-scroll.hbs for unified navigation rendering

Styling:
- chat-panel.css for Ask AI sidebar
- component-home-v3.css for new landing page layouts
- data-platform.css for umbrella page styling
- labs-home.css for labs directory
- product-switcher.css for top-level destination switcher
- Updated nav.css with bucket theming
- Updated markdown-dropdown.css for eyebrow positioning
- Inter Display font for landing pages

Components:
- product-switcher.hbs partial for three-destination switcher
- version-selector.hbs partial for per-bucket version dropdowns
- chat-panel.hbs with correct sparkle icon
- status-footer.hbs for version status information

Helpers:
- get-component-color.js, get-header-color.js, get-header-data.js
- get-component-header-data.js, get-home-navigation.js
- format-release-date.js, support-end-date.js, version-status.js
- Utility helpers: gte.js, lt.js, split.js, subtract.js

JavaScript:
- 19-chat-panel.js for Ask AI interactions
- 20-product-switcher.js for destination switching
- 21-breadcrumb-collapse.js for responsive breadcrumbs
- 22-version-selector.js for version dropdown
- 23-nav-bucket.js for bucket interactions
- Updated 14-markdown-dropdown.js to remove positioning logic

Fixes:
- Page options font consistency (11px, 600 weight)
- Focus outline visibility with proper padding
- Dropdown menu alignment
- Icon consistency (Connect plug-connected, Ask AI sparkle)

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

* Add test screenshots to gitignore

Exclude *.png files from repository root while preserving
legitimate images in /src/img/.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix dropdown positioning and add component-home-v3 icons

- Fix markdown dropdown positioning (focus outline cutoff, right overflow,
  mobile visibility)
- Add toolbar to component-home-v3 layout for mobile nav toggle
- Add new icon options: plug-connected, kubernetes, docker, linux
- Update helpers to support preview mode without contentCatalog
- Update preview-src/ui-model.yml with renamed components

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix squashed icons on component landing pages

Change SVG dimensions from width='16' height='16' to width='24' height='24'
to match viewBox='0 0 24 24'. This fixes visual distortion where icons
appeared compressed because the coordinate system didn't match the render size.

Affects: Kubernetes, Linux, Docker deployment option icons and Streaming/Connect
component card icons on Self-Managed landing page.

* Fix component-home-v3 icons for Connect, Kubernetes, Docker

- Use same plug icon as nav tree for Connect (plug-connected)
- Replace kubernetes icon with shield/helm badge shape
- Replace docker icon with stacked containers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix intro paragraph styling to only apply to first paragraph

Previously styled first 3 consecutive paragraphs as intro text.
Now only the first paragraph (or paragraphs with .lead class) gets
the larger intro styling.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Rename Redpanda Self-Managed to Redpanda Streaming

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add Ask AI chat persistence across page navigation

- chatPersistence.js: Save/restore conversation to localStorage with 24hr expiry
- persistentApiService.js: Wrap Kapa API to inject saved threadId
- AskAI.jsx: Use custom apiService, save conversation on answer completion
- ChatInterface.jsx: Restore conversation display on mount, clear on reset

Users can now navigate between pages and continue their chat conversation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix H1 hidden by component indicator on Bloblang playground

The component-indicator-sticky element has a negative top margin that
was causing it to overlap the H1 title on the playground page. This
adds a margin-top override specifically for the playground to prevent
the overlap.

* Hide component indicator on Bloblang playground

The component indicator was overlapping the H1 title on the playground
page due to the page's unique layout with a banner element. Since the
breadcrumbs already show the location (Connect > Bloblang > Playground),
the indicator is redundant and hiding it resolves the overlap issue while
keeping the H1 clearly visible.

* Restore component indicator on Bloblang playground with proper spacing

- Remove display: none that was hiding the indicator
- Override negative top margin to prevent overlap
- Add margin-top to H1 for proper spacing
- Indicator now sticks correctly like on other pages

* Fix H1 title visibility on Bloblang playground

Increase component indicator bottom margin from 24px to 48px to ensure
proper spacing between the eyebrow and H1 title. Both elements are now
fully visible without overlap.

* Swap Cloud and Self-Managed cards on Data Platform page

- Cloud card now appears first (left position)
- Self-Managed card now appears second (right position)
- Maintains all functionality and styling

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

* Add is-external-url helper for URL type detection

Handlebars helper to check if a URL is external (http/https).
Used in templates to conditionally handle external URLs vs Antora resource IDs.

Returns true for URLs starting with http:// or https://
Returns false for Antora resource IDs (component:module:page.adoc)

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

* Add error logging to resolve-resource helper

- Log detailed error context when resource resolution fails
- Include component, version, module, and page info in error
- Helps identify broken links during build
- Returns unresolved resource string as fallback

Errors format: [resolve-resource] Unresolved resource: "..." in context: {...}

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

* Update labs links to handle external URLs and Antora resource IDs

- Use is-external-url helper to detect URL type
- External URLs: add target="_blank" and rel="noopener noreferrer"
- Antora resource IDs: resolve through resolve-resource helper
- Applies to all 4 labs links on component home pages

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

* Hide all decorative icons on Cloud landing pages

- Remove path icons, deploy icons, feature icons, popular icons
- Icons don't provide meaningful value, clean up visual design
- Only diagonal arrows remain for external lab links (indicates new tab)

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

* Hide all decorative icons on Data Platform landing page

- Remove product bullet icons and popular topic icons
- Cleaner visual design without decorative elements
- Consistent with Cloud landing page icon removal

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

* Rename page-header-data to component-metadata in UI helpers

- Update all helper functions to use new attribute name
- More accurate: this is component-level metadata, not page-level
- Affected helpers: get-component-header-data, get-header-data, get-header-color, get-component-color, sort-components

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

* Rename page-header-data to component-metadata in templates

- Update product switcher template
- Update breadcrumbs template
- Update head component color template
- Consistent with helper function renames

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

* Fix mobile nav collapse/reopen bug and improve light mode visibility

- Fix mobile nav not reopening after collapse: Reset navToggle is-active
  state and remove is-clipped--nav from html when using sidebar collapse
- Add explicit light mode styles for nav-expand button with 2px border
  and stronger shadow for better visibility
- Make topbar fully opaque (remove 92% transparency) for better
  readability when scrolling over colored content
- Reduce gap between product selector and nav items in mobile nav
- Add mobile overflow menu for header actions
- Various CSS improvements for light/dark mode consistency

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix accessibility and build issues from CodeRabbit review

- Update wasm_exec.js to match Go GOROOT version
- Use semantic button for search trigger in nav.hbs
- Use semantic button for version selector trigger in nav-explore.hbs
- Add aria-expanded toggle for version dropdown in JS
- Fix announcement bar height mismatch (50px to 60px for mobile)
- Add focus-visible styles for new button elements

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix remaining CodeRabbit review issues

- Remove quotes from font-family in typeface-inter.css (stylelint fix)
- Use correct page attribute 'page-byoc-only' in is-byoc-feature.js
- Prevent mounting duplicate App instances in AskAI.jsx
- Remove AI help buttons when chat panel unavailable in bloblang-playground

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update Algolia search to handle new umbrella components

- Add Data Platform, Self-Managed, Home, Connect, Agentic Data Plane to TAGS_BY_COMPONENT
- Update productParams for View All link to handle new components
- Add UMBRELLA_COMPONENTS list for broader search context
- Rename LATEST_ENTERPRISE to LATEST_STREAMING
- Update site.components.ROOT references to site.components.streaming

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix Algolia search initialization error on pages without search container

- Add check for #autocomplete container before initializing
- Prevents 'Cannot read properties of null' error on pages without search

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add missing #autocomplete container for Algolia search

The autocomplete library needs a container element in the DOM

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Make topbar background solid instead of translucent

- Override component-specific translucent topbar colors
- Use solid white (#fff) for light mode
- Use solid ash-800 (#252525) for dark mode

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix CSS lint error: merge topbar-bg into existing theme selectors

- Added --topbar-bg to existing html[data-theme=dark] block
- Added --topbar-bg to existing html:not([data-theme=dark]) block
- Removed duplicate theme selector blocks that caused lint error
- Keeps topbar solid background for both light and dark modes

* Remove unused metadata proposal files

- Delete metadata-improved.css (never imported or used)
- Delete METADATA-UX-PROPOSAL.md (outdated proposal document)

These files were created as part of a UX exploration but were never
integrated into the actual implementation.

* Fix code review findings from PR #376

CSS fixes:
- Remove overflow:hidden from Ace editor containers to prevent scrollbar clipping
- Replace deprecated word-break:break-word with overflow-wrap:anywhere
- Replace deprecated clip with modern clip-path
- Rename camelCase keyframes to kebab-case (toastSlideIn→toast-slide-in, etc)

JavaScript fixes:
- Fix timezone handling in format-release-date (use UTC accessors)
- Update outdated comment referencing ROOT component
- Remove duplicate excludedRoles array in has-markdown
- Fix metadata persistence in Bloblang mini-playground
- Fix WASM initialization state cleanup on errors
- Hide all matching Ask AI buttons, not just first
- Use non-interactive span for breadcrumb fallbacks
- Move global event listeners outside forEach to avoid duplicates
- Update Ace editor minLines default from 4 to 5
- Add hyphenated YAML key support in Connect indicators

All changes validated with gulp lint and test:quick.

* Fix topbar transparency: use solid component-colored backgrounds

The topbar was using translucent backgrounds (8% opacity with transparent),
making it see-through. Changed to solid backgrounds using component colors:

- Light mode: color-mix(component 8%, white) - solid light tint
- Dark mode: color-mix(component 30%, #0f172a) - solid dark tint

Changes:
- src/partials/head-component-color.hbs: Changed from 'transparent' to solid backgrounds
- src/css/vars.css: Added solid topbar-bg for all 4 component-specific body selectors

This maintains the component color theming while ensuring the topbar is opaque.

* Fix Bloblang playground corner clipping issue

Add overflow: hidden to .editor-section-collapsible to clip content
to border-radius. This prevents child editors from bleeding outside
the rounded 8px corners of the container.

The overflow: hidden here only clips visual overflow to the border-radius.
The .editor elements inside have their own overflow: auto for scrollbars.

* Fix missing mobile nav toggle on home page

The toolbar (containing the nav-toggle button for mobile navigation) was
being excluded on pages with role="home", making the navigation menu
inaccessible on mobile devices.

Changes:
- Remove conditional that excluded toolbar on home pages
- Mobile users can now access the navigation menu on all pages

Testing:
- Verified nav-toggle button appears on home page in mobile viewport
- Confirmed navigation menu opens correctly when clicked
- All lint checks pass

Fixes mobile navigation accessibility issue.

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

* Add NEW badge system and interim home page structure

This commit implements two major features for the home page:

1. NEW Badge System:
   - Add is-new-resource.js helper to check if pages have page-new attribute
   - Display green "NEW" badges on home page cards when linked pages are new
   - Works with home page product cards and intent cards
   - Badge styles match existing pattern from component-home-v3

2. Interim Home Page (Pre-ADP Launch):
   - Add has-component.js helper for automatic component detection
   - Wrap ADP intent card and products section in conditionals
   - ADP cards automatically hide when component doesn't exist
   - ADP cards automatically show when component exists
   - Restructure Cloud card with nested sub-cards (Streaming, Connect, SQL)
   - Cloud structure now mirrors Self-Managed with parent-child pattern
   - SQL sub-card displays NEW badge when page has page-new attribute

3. Bug Fix:
   - Fix resolve-resource.js to handle undefined resources gracefully
   - Prevent "Cannot read properties of undefined" errors in templates

Files Changed:
- src/helpers/is-new-resource.js (NEW): Check for page-new attribute
- src/helpers/has-component.js (NEW): Detect component existence
- src/helpers/resolve-resource.js: Add undefined safety check
- src/css/home.css: Add NEW badge styles
- src/partials/home.hbs: Add conditionals, restructure Cloud card
- preview-src/home.adoc: Add Cloud sub-product attributes for testing

All changes preserve existing code for future ADP release. The conditional
logic ensures zero manual configuration - components show/hide automatically
based on their existence in the site model.

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

* Make data-platform interim home page with Ask AI and SQL NEW badge

Changes:
- Add Ask AI search input to data-platform hero with suggestion chips
- Add NEW badge support for Cloud BYOC SQL stat
- Fix is-new-resource helper to check all components (not just current)
- Fix overflow menu showing on desktop (add !important to display: none)
- Add Ask AI form handler JavaScript to data-platform template

This is the interim home page solution until ADP launches, highlighting
Redpanda SQL in Cloud BYOC with the NEW badge.

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

* Fix What's New styling and aggregation

- Add whats-new.css import to site.css (was missing, causing no styling)
- Fix aggregate-whats-new helper to get contentCatalog from options.data.root
- Update cloud-docs link to use full component prefix for proper resolution
- Add conditional layout class for What's New section
- Support both light and dark modes with proper CSS variables

* Add What's New support to component-home-v3 layout

- Add whats-new section to component-home-v3 template using get-whats-new-items helper
- Add CSS styling for ch3-whats-new-wrapper with proper width and spacing
- Section displays after hero and before tabs
- Ready for content team to add component-whats-new attributes to pages

* Fix navigation system and add home component nav support

- Fix nav-menu.hbs to use correct attributes (has-custom-nav, custom-navigation)
- Add logic to nav-menu-scroll.hbs to show home component's own navigation
- Create get-component-navigation helper to retrieve component navigation
- Mobile dropdown positioning fix for version selector
- Remove 'Home' from breadcrumbs hierarchy
- Skip pagination for home page
- Revert Cloud section to simple single card structure

* Add sparkles icon for ADP and clean up navigation debug code

- Add sparkles icon to bucket-header.hbs for ADP navigation
- Clean up debug comments from nav-menu-scroll.hbs
- Update test-home-component helper to check contentCatalog

* Increase component home hero width to 1100px to match data-platform

Makes hero sections consistent across all component landing pages (streaming,
cloud, connect, self-managed) by increasing from 720px to 1100px.

* Fix critical bugs and enhance landing pages with full-width layout

Critical Fixes:
- Fix undefined metadataContainer causing IntersectionObserver error in article.hbs
- Fix empty version dropdown for pages with "default" version in nav-explore.hbs
- Remove console.log debug statements from navigation helpers

Landing Page Enhancements:
- Make all landing page sections span full-width (remove max-width constraints)
- Apply consistent layout across data-platform and component-home-v3 pages
- Sections now extend edge-to-edge with padding, matching hero behavior
- Updated: .dp-section, .ch3-section, .ch3-tabs, .ch3-hero-columns

Ask AI Integration:
- Add Ask AI search bar to all component-home-v3 hero sections
- Add component-specific AI suggestion questions via get-ai-suggestions.js helper
- Suggestions configurable per component via antora.yml attributes (ai-suggestion-1 through ai-suggestion-4)
- Show Ask AI button on home page (previously hidden)
- Full styling matching data-platform design with sparkle icon

CSS Improvements:
- Add empty line before custom properties for stylelint compliance
- Consistent gutter and max-width variables across landing pages

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

* Hide labs section when no lab items are defined

Fix issue where labs section title appears on landing pages even when
no actual lab items (labs-1-title through labs-4-title) are provided.
Now only renders labs section if both title and at least one lab exist.

Fixes empty labs sections on streaming and connect landing pages.

* Fix AI suggestions and bold text rendering

- Fix HTML entities in AI suggestion questions (use triple braces)
- Fix bold text not appearing bold (use proper font-weight)

Fixes:
1. AI suggestions showed &#x27; instead of apostrophes
2. Bold markup (strong, b) rendered with lighter weight instead of bold

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

* Remove max-width constraints from home page sections

Makes home page layout consistent with other landing pages by removing
max-width constraints from:
- .home-hero-inner (was 1100px)
- .home-intent-container (was 900px)
- .home-products-container (was 900px)
- .home-paths-container (was 1000px)
- .home-nav-container (was 1200px)

Now uses full-width layout with gutter padding like data-platform and
component-home-v3 pages.

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

* Fix 'Ask AI about this topic' to open chat drawer instead of modal

Updated the page options 'Ask AI about this topic' button to:
- Open the new chat drawer instead of the old Kapa modal
- Pre-fill the chat input with context about the current page
- Focus the input field after opening

This makes the page options button consistent with the new Ask AI
drawer implementation.

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

* Fix mobile overflow menu visibility and click handler

- Remove !important from default hide rule to allow mobile override
- Add !important to mobile show rule for proper specificity
- Add tb-dropdown-trigger class to overflow button for JavaScript handler
- Fixes Labs and Ask a Human links not being accessible on mobile

* Fix version dropdown positioning on mobile in explore panel

- Add mobile breakpoint to prevent version dropdown from extending beyond viewport
- Set max-width to account for nav padding and prevent cutoff on left side
- Fixes version dropdown being cut off on streaming pages on mobile

* Fix version dropdown positioning on mobile in breadcrumbs

- Add mobile breakpoint to reset .breadcrumbs .sm-ver-panel positioning
- Allows component-home-v3 mobile centering styles to work correctly
- Version dropdown now centered and visible on screens <= 640px

* Fix version dropdown mobile positioning in sticky header and breadcrumbs

- Add mobile breakpoints for .component-indicator-sticky .sm-ver-panel
- Add mobile breakpoints for .breadcrumbs .sm-ver-panel
- Use position: fixed with top: 50%, left: 50% for mobile centering
- Use !important to override default positioning rules

* Fix version dropdown mobile positioning by removing CSS containment

The root cause was that .doc article has 'contain: layout style paint'
which creates a containing block for position:fixed elements, making
them position relative to the article instead of the viewport.

Solution:
- Remove containment from .doc when version selector is open on mobile
- Add transform: translate(-50%, -50%) for proper centering
- Apply fixes to both .component-indicator-sticky and .breadcrumbs contexts

The dropdown is now:
- Centered on screen (top: 50%, left: 50%)
- Fully visible in viewport
- Easy to close by clicking backdrop

* Remove underlines from version dropdown and fix mobile close behavior

CSS changes:
- Add !important to text-decoration: none on .sm-ver-row
- Add !important to text-decoration: none on .sm-ver-foot-link

JavaScript changes:
- Update close handler to check panel.contains() instead of smVer.contains()
- Add touchstart event handler for mobile support
- Prevent closing when clicking on panel content itself

Now clicking outside the panel properly closes it on mobile

* Fix home page spacing, font sizes, and add footer to landing pages

- Standardized section spacing: reduced home-products top padding from 80px to 56px, increased home-intent bottom padding from 48px to 56px for consistent 112px total
- Increased font sizes for better readability:
  - Intent card titles: 17px -> 19px
  - Intent card descriptions: 14px -> 15px
  - Product card titles: 14px -> 15px
  - Product card descriptions: 12px -> 13px
  - Product card links: 12px -> 13px
- Removed excessive empty space by eliminating padding-bottom from product grids
- Added footer to component-home-v3 landing pages (cloud, self-managed, streaming, connect)

Fixes spacing inconsistencies, improves text readability, and ensures all landing pages have proper footers.

* Restructure products section with two main clickable cards

- Changed layout from separate ADP/Data Platform sections to two-column main cards
- ADP card: Full clickable link to /agentic-data-plane/
- Data Platform card: Contains nested product cards (Cloud, Self-Managed)
- Cloud: Clickable link to cloud-data-platform/home
- Self-Managed: Contains sub-cards for Streaming and Connect
- All cards and nested cards are now clickable links
- Added arrow icons to indicate clickability
- Responsive design: stacks to single column on mobile

Improves navigation by making the entire product structure more hierarchical and clickable.

* Enhance product cards with descriptions, GIF, and quick links

- Added lead-in descriptions to both ADP and Data Platform main cards
- ADP card enhancements:
  - Added description: 'Multi-agent infrastructure'
  - Added animated GIF showing agent workflow (YOUR DATA -> AGENT -> ACTION)
  - Added quick links: 'Get started' and 'Documentation' buttons with icons
  - Changed from full card link to header link to accommodate internal content
- Data Platform card enhancement:
  - Added description: 'High-performance streaming data platform for mission-critical workloads'
  - Header remains clickable
- Fixed background color inconsistency: changed products section from var(--body-background) to var(--home-background) to match rest of page
- Added CSS for visual container, quick links with hover effects
- ADP card now has more content and visual interest

Addresses feedback about empty ADP card and white background inconsistency.

* Replace ADP card GIF with adp-infographic.gif

- Copied adp-infographic.gif from Downloads to home/modules/ROOT/images/
- Updated home.hbs to reference ./_images/adp-infographic.gif
- New GIF shows clearer agent workflow: YOUR DATA -> AGENT -> ACTION
- Includes 'GOVERNED END-TO-END · POLICY · AUDIT' messaging
- Fixed image path resolution to work correctly with Antora

The new infographic provides better visual representation of the Agentic Data Plane workflow.

* Add padding to PREV/NEXT pagination buttons

- Changed padding-left from 0 to 16px for .prev button
- Changed padding-right from 0 to 16px for .next button
- Text no longer sits flush against the border
- Provides better visual balance in the pagination cells

Fixes issue where PREV and NEXT text appeared scrunched up against the borders despite having large empty cells.

* Standardize font sizes to rem-based calculations with 1-2px increases

- Converted 358+ hardcoded pixel font sizes to rem-based calculations
- Increased all font sizes by 1-2px for improved readability
- Pattern: font-size: calc(px / var(--rem-base) * 1rem)
- Files affected: all CSS, templates, and helper files
- Sizes 10px and below increased by 2px
- Sizes 11px and above increased by 1px

This ensures consistent font scaling across all breakpoints and improves
accessibility while maintaining design proportions.

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

* Improve landing page UX: font sizes and clickable cards

Font Size Improvements:
- Increased font sizes across all landing pages for better legibility
- Product selector: 19px → 22px (names), 14px → 16px (taglines)
- Intent cards: 20px → 23px (titles), 16px → 17px (descriptions)
- Deploy cards: 17px → 19px (titles), 13px → 15px (descriptions)
- Popular topics: 15px → 17px (titles), 12px → 14px (descriptions)

Home Page Enhancements:
- Made intent cards clickable (Build agentic workflows → ADP home, Stream and process data → Data Platform home)
- JavaScript-based click handling preserves nested link functionality
- Added data-href attributes to card elements

Bug Fixes:
- Fixed sticky header content bleed-through (removed negative margin)

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

* Add component and deployment cards to cloud landing page

- Remove What's New sections from all landing pages
- Add component cards section with Streaming, Connect, SQL
- Add deployment cards section with Serverless, BYOC, Dedicated
- SQL component shows NEW badge and Cloud BYOC badge
- Use dynamic component colors from antora.yml metadata
- Fix z-index stacking for sticky component indicator
- Clean up code comments and fix CSS linting errors

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

* Add decision matrix section to data platform landing page

* Apply ESLint formatting to vendor files

Automatic formatting improvements applied by ESLint to Ace editor and
WASM exec vendor files. Changes are purely stylistic (line breaks, brace
placement) for consistency with project linting rules.

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

* Fix Ace loading race condition, increase heading sizes, fix version selector xrefs

- Fix Bloblang playground Ace editor race condition by dispatching aceReady event
  when all scripts load and waiting for it before initializing editors
- Increase all .doc heading font sizes by 2px (h1: 34/42, h2: 26, h3: 22, h4: 19, h5: 18, h6: 17)
- Fix version selector xref resolution by converting module-relative xrefs to
  fully qualified format (version@component:module:page.adoc)
- Ensure Bloblang playground title visible on mobile with explicit styles
- Align bump integration fonts with main site (JetBrains Mono)
- Remove unused Inter Display font files
- Various CSS and template cleanups

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Increase Bloblang playground font sizes

- Notification text: 14px → 16px
- Validation indicator: 12px → 14px

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix search Ask AI button and labs home error

- Search Ask AI button now opens chat drawer instead of Kapa modal
- Add missing #labs-results-num container for Algolia stats widget

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Style search Ask AI button to match top nav

- Use purple gradient background matching .tb-ai-btn
- Add light/dark mode support with hover effects
- SVG icon uses currentColor for proper color inheritance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add topbar button styles to header-bump.css

Include .tb-ai-btn, .tb-btn, .tb-link, and .tb-dropdown styles
for the standalone header widget used in API docs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add docs-footer styles to footer-bump.css

Include compact footer styles used by API docs and embedded pages.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix TOC highlighting when clicking TOC items

Add click handlers to TOC links that immediately set the correct active
state, preventing the wrong item from being highlighted during scroll
animations. The fix also temporarily skips scroll-based updates for 100ms
after a click to prevent flicker.

Applies to both sidebar TOC and embedded dropdown TOC (mobile).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove icon from beta status badge

Simplified beta badge to show only text without the SVG icon.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Hide Ask AI and mobile overflow menu in standalone widget

These elements don't work in the bump widget context since the chat
functionality and main site JavaScript aren't available on API pages.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix theme switcher visibility in bump widget

Updated filter on .theme-image to show dark icon in light mode and
light icon in dark mode, matching the main site styling.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add search and Ask AI buttons to API widget header

- Add search button (DocSearch) for standalone API widget
- Restore Ask AI button (was incorrectly hidden in widget)
- Restore mobile overflow menu (was incorrectly hidden in widget)
- Add CSS styles for new search button with light/dark mode support

The search button only appears in the standalone widget context
(isStandaloneWidget=true) as regular pages have search elsewhere.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix Ask AI button in standalone widget

The Ask AI button with data-action="open-chat" now works in the
standalone widget context (API pages) by directly opening Kapa
when no chat panel element exists.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Hide mobile overflow menu on desktop

Add CSS to hide .tb-overflow-menu by default (desktop) and only
show it on mobile (max-width: 480px).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Hide breadcrumbs in standalone API widget

Breadcrumbs are not needed in API docs since Bump.sh has its own
navigation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update standalone API widget: new brand, exclude Ask AI

- Replace navbar-brand with sb-head structure for standalone widget
  (shows "Redpanda / Documentation" with logo)
- Exclude Ask AI button from standalone widget (not working in that context)
- Keep breadcrumbs excluded from standalone widget
- Keep Search button for standalone widget
- Add CSS styles for sb-head component in header-bump.css

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update wasm_exec.js to match Go installation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Michele Cyran <michele@redpanda.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@micheleRP