Skip to content

[Epic Branch] ADP pkg1#494

Draft
paulohtb6 wants to merge 176 commits intomainfrom
adp-pkg1
Draft

[Epic Branch] ADP pkg1#494
paulohtb6 wants to merge 176 commits intomainfrom
adp-pkg1

Conversation

@paulohtb6
Copy link
Contributor

@paulohtb6 paulohtb6 commented Jan 29, 2026

Description

This PR serves as the EPIC PR for ADP in package 1.

It merges the following PRs:
update cloud overview adp focus -
Transcripts - REPLACED WITH PR #498
AI agents
AI Gateway
AuthZ

Page previews

Global preview - https://deploy-preview-494--rp-cloud.netlify.app/

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

micheleRP and others added 30 commits January 14, 2026 16:58
# Conflicts:
#	modules/ROOT/nav.adoc
Added 7 new documentation files for AI Gateway:
- what-is-ai-gateway.adoc: Overview, problem/solution framing, common patterns
- quickstart-enhanced.adoc: Step-by-step quickstart with time markers
- observability-logs.adoc: Request logs, filtering, and debugging
- observability-metrics.adoc: Dashboards, analytics, and cost tracking
- migration-guide.adoc: Safe migration from direct provider integration
- cel-routing-cookbook.adoc: CEL routing patterns with examples
- mcp-aggregation-guide.adoc: MCP aggregation and orchestration

All files follow Redpanda documentation standards:
- Sentence case headings
- Imperative verbs for action headings
- AsciiDoc format
- Comprehensive placeholders for product-specific details

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add personas, learning objectives, and prerequisites to all AI Gateway
documentation pages. Remove DRAFT prefixes from titles and time estimates
from quickstart. Fix passive voice in multiple locations.

Changes:
- Add page-personas attributes to all 7 files
- Add learning objectives in ABCD format
- Add prerequisites sections where missing
- Remove "DRAFT:" from all page titles
- Remove time estimates from quickstart-enhanced.adoc
- Fix passive voice constructions
- Improve page descriptions
- Preserve all placeholder comments for future content

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Provide admin and user guides for configuring Claude Code, Cline, Continue.dev, Cursor IDE, and GitHub Copilot to work with AI Gateway, enabling centralized LLM routing and MCP tool aggregation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Fix period usage in numbered steps and bold labels across all AI agent docs
- Add descriptive link text to xref anchor links for better accessibility
- Redesign monitor-agents.adoc reducing lists from 9 to 2, converting to prose and tables
- Create observability index page
- Fix broken xref from billing.adoc to observability/concepts.adoc
- Change negative headings to positive action-oriented headings
- Add explicit 'Enter this query' instructions for each test scenario
- Add guidance on what to watch for in the conversation panel
- Specify when to start new sessions for context clearing
Moved monitoring how-tos into context where users need them:
- Monitor Agents now in agents section
- Monitor MCP Servers now in mcp/remote section
- Observability concepts remain centralized as single source of truth

This follows the "procedures in context, concepts centralized" pattern,
reducing navigation overhead and improving task completion.

Also removed unnecessary observability index page since only one page
remains in that section.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sessions and tasks topics are being soft-hidden with __ prefix as they
are internal implementation details. Updated documentation to focus on
user-facing monitoring features (transcripts and inspector).

Changes:
- Remove "Agent data topics" section from concepts.adoc with schemas
- Remove "Consume agent data topics" section from monitor-agents.adoc
- Update troubleshooting.adoc to reference transcripts instead of topics
- Update learning objective to "Track token usage and performance metrics"
- Fix xref anchor links to include descriptive text
- Fix shipping carrier name to comply with Google style guide

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…oud-team-polish-clean-up

# Conflicts:
#	modules/ROOT/nav.adoc
#	modules/ai-agents/pages/mcp/index.adoc
kbatuigas and others added 30 commits February 5, 2026 14:34
Replace model="auto" with realistic model names in CEL examples,
fix UI navigation paths to use Agentic AI sidebar structure,
confirm streaming and response format compatibility, uncomment
verification command, comment out unverified CEL sections (A/B
testing, time-based routing, reject), revise geographic routing
to use different providers, and update observability integrations
to confirmed Prometheus + OpenTelemetry.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
# Conflicts:
#	modules/ai-agents/pages/observability/ingest-custom-traces.adoc
Update all AI Gateway documentation to use latest model versions:
- OpenAI: gpt-5.2, gpt-5.2-mini (was gpt-4o, gpt-4o-mini)
- Anthropic: claude-sonnet-4.5, claude-opus-4.6 (was claude-sonnet-3.5, claude-opus-4)
- Add Google Gemini: gemini-2.0-flash, gemini-2.0-pro

Updated 27 files including core docs, admin/builder guides, integration guides, CEL routing examples, and code samples across all documentation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Move AI Hub documentation to partials folder to preserve content but prevent rendering in Package 1 release:
- Move configure-ai-hub.adoc, eject-to-custom-mode.adoc, use-ai-hub-gateway.adoc, gateway-modes.adoc to partials/ai-hub/
- Wrap all xrefs to AI Hub pages with ifdef::ai-hub-available[] conditionals
- Remove AI Hub pages from nav.adoc
- Update 7 files with conditional xrefs: gateway-quickstart, setup-guide, discover-gateways, what-is-ai-gateway, gateway-architecture, ai-hub-preference-toggles

AI Hub content preserved for future Package 2 release.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Joyce Fee <102751339+Feediver1@users.noreply.github.com>
Gateway ID is now embedded in the endpoint URL path instead of passed
as a separate rp-aigw-id HTTP header. Updated all code examples, UI
navigation, and documentation across 22 files. Also updated
observability dashboard references to point to the gateway Overview tab
where applicable, and commented out references to UI features not yet
available.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Update MCP server fields to match Create MCP Server dialog (Server ID,
  Display Name, Server Address, Defer Loading Override, Forward OIDC
  Token Override)
- Update orchestrator section to reflect system-managed config with
  configurable blocked tool patterns
- Update deferred loading config to use per-server Defer Loading Override
  dropdown instead of gateway-level toggle
- Update observability references to point to gateway Overview tab
- Comment out references to UI features not yet available

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
# Conflicts:
#	modules/ai-agents/pages/observability/concepts.adoc
…lish-clean-up' into adp-pkg1

# Conflicts:
#	modules/ai-agents/pages/mcp/remote/tool-patterns.adoc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants