Skip to content

DOC-1935 add glossterms for ADP#1564

Merged
micheleRP merged 4 commits intosharedfrom
DOC-1935
Feb 4, 2026
Merged

DOC-1935 add glossterms for ADP#1564
micheleRP merged 4 commits intosharedfrom
DOC-1935

Conversation

@micheleRP
Copy link
Contributor

@micheleRP micheleRP commented Feb 3, 2026

Description

This pull request introduces a comprehensive set of new and updated glossary terms for Redpanda and agentic systems, focusing on AI agents, protocols, authentication, and related infrastructure.

  • Added definitions for key agentic concepts, including Agentic Data Plane (ADP), Model Context Protocol (MCP), and many others. Each term includes a description, hover text, category, and cross-references to related terms.
  • Updated authentication and authorization terms to include standard abbreviations (AuthN, AuthZ) and clarified their role in Redpanda security.
  • Added definition for identity provider (IdP), explaining its function in authentication and token issuance, with references to related security terms.
  • Fixed typo in Kafka API term

Resolves https://redpandadata.atlassian.net/browse/DOC-1935
Review deadline:

Page previews

Glossary

Checks

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

@micheleRP micheleRP requested a review from a team as a code owner February 3, 2026 00:33
@netlify
Copy link

netlify bot commented Feb 3, 2026

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 57774c9
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/698164a61e3cef00070cf478
😎 Deploy Preview https://deploy-preview-1564--redpanda-docs-preview.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.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 3, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

  • 🔍 Trigger a full review
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch DOC-1935

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@kbatuigas kbatuigas Feb 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the idea behind having separate terms for transcript and trace is to explain that trace has a more general definition outside of Redpanda (i.e. with OpenTelemetry), and transcript is our take? interpretation? inspired by Anthropic, and is also closely tied to how we want to present this data in the UI. But will need Marc and others to chime in and confirm.

For example, if we tell users how to hook up their external agents to our otel ingestion pipeline, I think we would need to refer to both the otel trace and the ADP transcript, in that specific context the two are even less interchangeable

Comment on lines 1 to 2
=== authentication (AuthN)
:term-name: authentication (AuthN)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not sure that works. It will prob no highlight just "authentication".

Do we have an "alias" feature where we can put multiple names for the same term?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have acronyms in other glossterms too and works fine like here... but I've moved AuthZ and AuthN into the descriptions

@micheleRP micheleRP merged commit 75b4da9 into shared Feb 4, 2026
5 checks passed
@micheleRP micheleRP deleted the DOC-1935 branch February 4, 2026 14:36
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.

4 participants