Skip to content

Add 26.2 features (client compatibility, Iceberg translation) to What's New in Cloud - #657

Open
kbatuigas wants to merge 3 commits into
mainfrom
DOC-2312-2311-2290-cloud-26.2-single-source
Open

Add 26.2 features (client compatibility, Iceberg translation) to What's New in Cloud#657
kbatuigas wants to merge 3 commits into
mainfrom
DOC-2312-2311-2290-cloud-26.2-single-source

Conversation

@kbatuigas

@kbatuigas kbatuigas commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Description

Related single-sourcing update PR redpanda-data/docs#1857

This pull request updates documentation for Redpanda Cloud, primarily adding new release notes for August 2026 and making a minor change to the Antora playbook configuration. The most important changes are grouped below.

Documentation updates for new features:

  • Added an August 2026 section to whats-new-cloud.adoc with the following highlights:
    • Support for decoding Iceberg keys, values, and headers independently on BYOC clusters via enhanced redpanda.iceberg.mode topic property.
    • Ability to resolve Iceberg topic schemas within a specific Schema Registry context using the redpanda.schema.registry.context property.
    • Expanded validation for additional non-Java Kafka clients (confluent-kafka-go, Sarama, confluent-kafka-python) aligned with Kafka 4.x.

Antora playbook configuration:

  • Updated the branch list for the Redpanda documentation source in local-antora-playbook.yml to include DOC-2312-2311-2290-cloud-26.2-single-source instead of main.

Resolves https://github.com/redpanda-data/documentation-private/issues/
Review deadline:

Page previews

Checks

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

@kbatuigas
kbatuigas requested a review from a team as a code owner July 31, 2026 00:17
@netlify

netlify Bot commented Jul 31, 2026

Copy link
Copy Markdown

Deploy Preview for rp-cloud ready!

Name Link
🔨 Latest commit 6e822c1
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/6a6be99cb83c610008271a37
😎 Deploy Preview https://deploy-preview-657--rp-cloud.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

coderabbitai Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

The documentation content source now tracks the cloud 26.2 single-source branch instead of main. The cloud “What’s New” page adds August 2026 notes for independent Iceberg key, value, and header decoding, Schema Registry context resolution, and validation of Go, Sarama, and Python Kafka clients against Kafka 4.x-aligned versions.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: feediver1

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly summarizes the primary documentation changes covering client compatibility and Iceberg translation features.
Description check ✅ Passed The description is detailed and follows the template, but the issue number, review deadline, page preview, and check selection remain incomplete.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch DOC-2312-2311-2290-cloud-26.2-single-source

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

Comment thread local-antora-playbook.yml
branches: HEAD
- url: https://github.com/redpanda-data/docs
branches: [main, v/*, shared, site-search]
branches: [DOC-2312-2311-2290-cloud-26.2-single-source, v/*, shared, site-search]

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
branches: [DOC-2312-2311-2290-cloud-26.2-single-source, v/*, shared, site-search]
branches: [main, v/*, shared, site-search]

commit before merge

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@modules/get-started/pages/whats-new-cloud.adoc`:
- Around line 19-21: Update the “Expanded Kafka client validation” release-note
section to state the validated versions for confluent-kafka-go, Sarama, and
confluent-kafka-python, and update the linked Kafka Compatibility page to
include matching entries for all three clients. Ensure the release note and
compatibility table use the same explicit version details.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 89001078-eb3b-41af-913c-cf8dacd72931

📥 Commits

Reviewing files that changed from the base of the PR and between 38e0176 and 6e822c1.

📒 Files selected for processing (2)
  • local-antora-playbook.yml
  • modules/get-started/pages/whats-new-cloud.adoc

Comment on lines +19 to +21
=== Expanded Kafka client validation

Redpanda now validates additional non-Java Kafka clients at their current versions, aligned with Kafka 4.x: confluent-kafka-go, Sarama, and confluent-kafka-python. See xref:develop:kafka-clients.adoc[Kafka Compatibility].

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -e
printf '%s\n' '--- candidate files ---'
fd -i 'kafka|whats-new-cloud' . | head -80
printf '%s\n' '--- relevant references ---'
rg -n -i -C 3 'confluent-kafka-go|Sarama|confluent-kafka-python|current versions|Kafka Compatibility|Kafka 4\.x' . --glob '*.adoc' --glob '*.md' --glob '*.yaml' --glob '*.yml' | head -240

Repository: redpanda-data/cloud-docs

Length of output: 1649


🏁 Script executed:

#!/bin/bash
set -e
printf '%s\n' '--- Kafka compatibility outline ---'
ast-grep outline modules/develop/pages/kafka-clients.adoc
printf '%s\n' '--- Kafka compatibility contents ---'
cat -n modules/develop/pages/kafka-clients.adoc
printf '%s\n' '--- release-note context ---'
sed -n '1,45p' modules/get-started/pages/whats-new-cloud.adoc

Repository: redpanda-data/cloud-docs

Length of output: 4421


🏁 Script executed:

#!/bin/bash
set -e
printf '%s\n' '--- source include and repository configuration ---'
rg -n -C 4 'streaming:develop:kafka-clients|single-source|streaming' . --hidden -g '!*.lock' -g '!node_modules' | head -240
printf '%s\n' '--- git submodules and tracked references ---'
if test -f .gitmodules; then cat .gitmodules; else echo 'no .gitmodules'; fi
git ls-files | rg -i 'kafka-clients|antora|playbook|site\.yml|\.yml$|\.yaml$' | head -160
printf '%s\n' '--- all client-name occurrences in tracked content ---'
git grep -n -i -E 'confluent-kafka-go|Sarama|confluent-kafka-python|Kafka 4\.x|current versions' -- ':!modules/get-started/pages/whats-new-cloud.adoc' || true

Repository: redpanda-data/cloud-docs

Length of output: 24063


🏁 Script executed:

#!/bin/bash
set -e
repo='https://api.github.com/repos/redpanda-data/docs/contents/modules/develop/pages/kafka-clients.adoc'
for ref in main shared 'DOC-2312-2311-2290-cloud-26.2-single-source'; do
  printf '\n--- ref: %s ---\n' "$ref"
  url="${repo}?ref=$(printf '%s' "$ref" | sed 's/ /%20/g')"
  curl -fsSL "$url" | jq -r '.download_url // .message'
done
printf '\n--- matching remote branches ---\n'
git ls-remote --heads https://github.com/redpanda-data/docs.git \
  | grep -E 'DOC-2312-2311-2290-cloud-26\.2-single-source|refs/heads/(main|shared)$' || true

Repository: redpanda-data/cloud-docs

Length of output: 557


🏁 Script executed:

#!/bin/bash
set -e
for ref in main shared; do
  printf '\n--- docs/modules/develop/pages/kafka-clients.adoc @ %s ---\n' "$ref"
  curl -fsSL "https://raw.githubusercontent.com/redpanda-data/docs/$ref/modules/develop/pages/kafka-clients.adoc" \
    | tee "/tmp/kafka-clients-$ref.adoc" \
    | grep -in -E -C 5 'confluent-kafka-go|Sarama|confluent-kafka-python|version|Kafka 4' || true
done

Repository: redpanda-data/cloud-docs

Length of output: 484


🏁 Script executed:

#!/bin/bash
set -e
for ref in main shared; do
  out="/tmp/kafka-clients-$ref.adoc"
  printf '\n--- docs/modules/develop/pages/kafka-clients.adoc @ %s ---\n' "$ref"
  if curl -fsSL "https://raw.githubusercontent.com/redpanda-data/docs/$ref/modules/develop/pages/kafka-clients.adoc" > "$out"; then
    wc -c "$out"
    grep -in -E -C 6 'confluent-kafka-go|Sarama|confluent-kafka-python|version|Kafka 4' "$out" || true
  else
    echo 'not available'
  fi
done

Repository: redpanda-data/cloud-docs

Length of output: 4652


🏁 Script executed:

#!/bin/bash
set -e
src=/tmp/kafka-clients-main.adoc
test -s "$src"
python3 - "$src" <<'PY'
import re, sys
from pathlib import Path

source = Path(sys.argv[1]).read_text()
cloud = re.search(r'ifdef::env-cloud\[\]\n(.*?)endif::\[\]', source, re.S)
if not cloud:
    raise SystemExit("cloud conditional block not found")
cloud_text = cloud.group(1)
for name in ("confluent-kafka-go", "Sarama", "confluent-kafka-python"):
    print(f"{name}: {'present' if name in cloud_text else 'absent'}")
print("cloud block has explicit client version:", bool(re.search(r'\b(?:v|version\s*)\d+\.\d+', cloud_text, re.I)))
print("cloud block uses current-version wording:", bool(re.search(r'current versions?', cloud_text, re.I)))
release = Path("modules/get-started/pages/whats-new-cloud.adoc").read_text()
line = next(line for line in release.splitlines() if "Expanded Kafka client validation" in line or "current versions" in line)
print("release-note:", line)
PY

Repository: redpanda-data/cloud-docs

Length of output: 381


Document the validated client versions and expose them in the linked compatibility page.

The cloud-rendered page omits these three clients and lists no explicit versions, so this release note’s claim cannot be substantiated.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@modules/get-started/pages/whats-new-cloud.adoc` around lines 19 - 21, Update
the “Expanded Kafka client validation” release-note section to state the
validated versions for confluent-kafka-go, Sarama, and confluent-kafka-python,
and update the linked Kafka Compatibility page to include matching entries for
all three clients. Ensure the release note and compatibility table use the same
explicit version details.

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