docs: archive stale AI Gateway pages and align overview positioning#60
Merged
Merged
Conversation
Removes four legacy "gateway-object model" pages from the rendered docs (nav + all inbound links) and preserves their content verbatim in an un-included partial. Also aligns the ADP overview and agents overview with the GA field capability guide. Archived to modules/gateway/partials/archived-ai-gateway-pages.adoc (never include::d, so it renders nowhere): - get-started/gateway-quickstart - gateway/gateway-architecture - gateway/admin/setup-guide - gateway/builders/discover-gateways These described gateways-with-IDs, provider pools/failover, gateway rate/spend limits, and API-key auth, which do not match the shipped GA model (LLM Providers + OIDC; per-agent budgets under Control & Govern). Delinking: - nav.adoc: dropped the two "Routing & LLM Settings" entries. - adp-overview Next steps and both tutorial prerequisites retargeted to gateway:configure-provider.adoc. - gateway/overview.adoc :page-aliases: now also absorbs the old cloud gateway-quickstart URL (gateway-architecture and discover-gateways already redirected there). - Refreshed the cleanup note in configure-provider.adoc. Positioning (capability-guide audit, tiers 1-2): - Rewrote the adp-overview "AI Gateway" section to the managed-proxy / LLM-Provider / OIDC model; dropped routing, failover, per-tenant budgets, and rate limiting (not in GA) and pointed spend control to per-agent budgets. - De-emphasized the "300+ connectors" marketing number in adp-overview and agents-overview (kept factual Redpanda Connect architecture references); removed the forward-looking "upcoming templates" sentence; softened the ISO 42001 / EU AI Act compliance framing to "supports audit and compliance efforts." Local build clean: 0 broken xrefs, 0 unlisted-page warnings. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for redpanda-agentic-data-plane ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Implements the documentation side of the AI Gateway cleanup from the GA field-capability-guide audit: archives the stale "gateway-object model" pages and aligns the ADP overview with the shipped GA model.
Archived (content preserved, not rendered)
Moved four legacy pages into
modules/gateway/partials/archived-ai-gateway-pages.adoc. The partial is neverinclude::d, so nothing renders, but the content is retained verbatim (with a header explaining how to restore):get-started/gateway-quickstartgateway/gateway-architecturegateway/admin/setup-guidegateway/builders/discover-gatewaysThey described gateways-with-IDs, provider pools/failover, gateway rate/spend limits, and API-key auth — none of which match the shipped GA model (LLM Providers + OIDC; per-agent budgets under Control & Govern).
Delinking
adp-overviewNext steps and both tutorial prerequisites togateway:configure-provider.adoc.gateway/overview.adoc:page-aliases:now also absorbs the old cloudgateway-quickstartURL (the other old URLs already redirected there).Positioning (capability-guide audit, tiers 1-2)
adp-overviewAI Gateway section to the managed-proxy / LLM-Provider / OIDC model; dropped routing, failover, per-tenant budgets, and rate limiting (not in GA) and pointed spend control to per-agent budgets.adp-overviewandagents-overview(kept factual Redpanda Connect architecture references), removed the forward-looking "upcoming templates" sentence, and softened the ISO 42001 / EU AI Act compliance framing to "supports audit and compliance efforts."Build
Local
npm run buildis clean: 0 broken xrefs, 0 unlisted-page warnings (this also clears the two pre-existing unlisted warnings for setup-guide / discover-gateways).Deliberately left alone
connect/partials/integrations/*partials (held behind the offintegrations-availableflag; slated for the post-GA integrations rewrite) still reference old gateway-quickstart steps. They don't render and don't affect the build.monitor/partials/observability-metrics.adoc(included nowhere).Preview pages
Metadata-only changes, omitted above (no visible diff):
gateway/overview(page alias) andgateway/configure-provider(comment). The four archived pages are removed, so they have no preview.🤖 Generated with Claude Code