Skip to content

Remove unnecessary cross-repo links and fix description backticks#28

Merged
micheleRP merged 2 commits into
mainfrom
remove-unnecessary-cloud-docs-links
May 22, 2026
Merged

Remove unnecessary cross-repo links and fix description backticks#28
micheleRP merged 2 commits into
mainfrom
remove-unnecessary-cloud-docs-links

Conversation

@micheleRP
Copy link
Copy Markdown
Contributor

@micheleRP micheleRP commented May 22, 2026

Summary

  • Drop three cross-repo xrefs that pulled readers out of adp-docs without real benefit: the tangential "Account impersonation" pointer in the permissions overview (flagged by Santi after PR Document ADP fine-grained permissions for DOC-2041 #23), the generic "more about processors" bullet in pipeline-integration-patterns "Next steps", and the "Redpanda Connect" link on the ADP home page (sentence preserved, no link).
  • Strip backticks from three :description: attributes (connect-agent, rpk/index, rpk-install) so listing pages like /redpanda-adp/reference/ render the text cleanly instead of showing literal backticks.
  • Rename the observability concepts page from "Transcripts and AI Observability" to "Observability" so the home-page next-steps link reads cleanly, and update two hard-coded references in byoa-telemetry to match.

Preview pages

Test plan

  • Netlify deploy preview for /redpanda-adp/governance/permissions-overview/#identity-and-impersonation reads cleanly without the removed sentence.
  • /redpanda-adp/agents/pipeline-integration-patterns/#next-steps shows three bullets (no Connect processors bullet).
  • /redpanda-adp/ home page "AI agents" sentence reads naturally with no link on "Redpanda Connect"; "Next steps" reads "Observability" (not "Transcripts and AI Observability").
  • /redpanda-adp/reference/ rpk description renders without literal backticks.
  • /redpanda-adp/ai-gateway/connect-agent/ and /redpanda-adp/get-started/rpk-install/ page intros still render normally.
  • /redpanda-adp/observability/concepts/ page title shows "Observability"; nav still labels it "Concepts".

🤖 Generated with Claude Code

Drop three xrefs to cloud-docs that send readers out of adp-docs without
real benefit: the tangential "Account impersonation" pointer in the
permissions overview, the generic Connect processors bullet in the
pipeline integration "Next steps", and the Redpanda Connect link on the
ADP home page (sentence preserved).

Strip backticks from three :description: attributes so listing pages
(for example /redpanda-adp/reference/) render the text cleanly instead
of showing literal backticks.

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 22, 2026 22:22
@netlify
Copy link
Copy Markdown

netlify Bot commented May 22, 2026

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

Name Link
🔨 Latest commit b094bbb
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a10d934e003c500087d8627
😎 Deploy Preview https://deploy-preview-28--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.

The home-page next-steps link uses an empty xref label, so the title
showed through as "Transcripts and AI Observability." Shorten the page
title to "Observability" and update the two byoa-telemetry references
that hard-coded the old title. Nav label ("Concepts") and the inline
"Transcripts Overview" link from the home page's Transcripts section
are intentionally different and stay as is.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP merged commit ea3b55b into main May 22, 2026
4 checks passed
@micheleRP micheleRP deleted the remove-unnecessary-cloud-docs-links branch May 22, 2026 22:53
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.

1 participant