Skip to content

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

Open
kbatuigas wants to merge 4 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 4 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:

  • Pointed the Redpanda documentation source in local-antora-playbook.yml at the docs PR branch DOC-2312-2311-2290-26.2-single-source (instead of main) so this Cloud preview renders the single-sourced changes from #1857.

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

Page previews

Cloud (single-sourced) renderings — for SME review of Cloud accuracy:

The Specify Iceberg Schema and Kafka Compatibility pages are single-sourced from redpanda-data/docs#1857. This Cloud preview pulls that docs branch (via local-antora-playbook.yml) and applies env-cloud, so it shows the Cloud rendering of the shared content. The self-managed rendering is previewed on #1857.

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 a1e8bbd
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/6a70c902eef4a600084b98c1
😎 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.
🤖 Make changes Run an agent on this branch

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

Important

Review skipped

Auto incremental reviews are disabled on this repository.

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.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 142ae07f-db26-4685-a064-c4a17473a7f6

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

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 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 | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description clearly explains the changes and includes previews, but the issue number, review deadline, and check classification remain incomplete. Replace the issue placeholder, add the review deadline, and select the applicable checkbox under Checks.
✅ Passed checks (4 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 main documentation changes for client compatibility and Iceberg translation.
✨ 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 Outdated
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.

@kbatuigas
kbatuigas force-pushed the DOC-2312-2311-2290-cloud-26.2-single-source branch from fc24153 to a2b45b4 Compare August 3, 2026 16:50
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