Skip to content

docs: reorder What's New per review; mark Tiered Storage v2 as beta - #1839

Merged
JakeSCahill merged 4 commits into
betafrom
whats-new-reorder-tsv2-beta
Jul 28, 2026
Merged

docs: reorder What's New per review; mark Tiered Storage v2 as beta#1839
JakeSCahill merged 4 commits into
betafrom
whats-new-reorder-tsv2-beta

Conversation

@Feediver1

@Feediver1 Feediver1 commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Follow-up to Matt Schumpert's review feedback on #1828 (DOC-2395).

Changes

What's New reorder (get-started/release-notes/redpanda.adoc)

New entry order per Matt's requested grouping:

  1. Shadowing (migrate schemas from Confluent, role synchronization, Cloud Topics support)
  2. Kafka 4.x client compatibility
  3. Deferred upgrade finalization
  4. Fetch read coalescing, Per-entity client quota metrics, Cloud Topics enabled by default (not named in the new ordering — kept together here in their previously requested relative order; easy to move if they belong elsewhere)
  5. Schema Registry contexts (Iceberg translation binding)
  6. Iceberg (key and header translation)
  7. Health monitoring (Iceberg health, cluster health metrics)
  8. Tiered Storage v2, last among features and now clearly marked beta

The combined Iceberg translation and health monitoring entry is split into three entries (Schema Registry context, key/header translation, health monitoring) so the grouping above works.

Tail sections follow the usual release-notes order (per 25.3): Redpanda CLI (rpk)New configuration properties → deprecations (rpk redpanda admin deprecated).

Tiered Storage v2 beta marking

  • What's New: badge::[label=beta] on the entry heading plus the standard beta notice (not supported for production, feedback link), mirroring the public-beta.adoc boilerplate.
  • Source (manage/partials/tiered-storage.adoc, Choose a Tiered Storage version): badge on the tiered_v2 bullet and an IMPORTANT beta notice.

Review notes

  • No wording changes to any entry other than the beta notice; this is purely reordering, the entry split, and beta marking.
  • The Tiered Storage partial is included by the Tiered Storage page; the beta notice renders wherever the partial does.

🤖 Generated with Claude Code

Property reference regeneration (v26.2.1)

Review of the New configuration properties section revealed the generated property reference was stale (last built from v26.1.13): the 26.2 feature properties (kafka_fetch_read_coalescing_enabled, kafka_per_entity_quota_metrics, health_monitor_metrics_enabled, and others) had no reference entries, so several What's New deep links pointed at nonexistent anchors.

  • Regenerated the property partials from the v26.2.1 GA tag (diffed against v26.1.14) via doc-tools.
  • Expanded New configuration properties from 1 listed property to all 29 new in 26.2, grouped by category (Shadowing, Schema Registry, Metrics and monitoring, Performance, Tiered Storage, Iceberg, Cloud Topics, Object storage I/O), following the 26.1 format.
  • Fixed the TSv2 entry xref: default_redpanda_storage_mode_tiered_impl is documented on the object storage properties page, not cluster properties.

Preview pages

  • What's New in Redpanda (reordered; Tiered Storage v2 entry renders the beta badge and notice)
  • Tiered Storage (beta badge and IMPORTANT notice in the Choose a Tiered Storage version section)

- Reorder entries: Shadowing, Kafka compatibility, deferred upgrades,
  Schema Registry contexts, Iceberg, health monitoring, Tiered Storage
  v2 last; CLI, properties, and deprecations keep their usual tail
  order.
- Split the combined Iceberg entry into Schema Registry context,
  key/header translation, and health monitoring entries.
- Mark Tiered Storage v2 as beta in the What's New entry and in the
  Tiered Storage feature docs (badge macro plus beta notice).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Feediver1
Feediver1 requested a review from a team as a code owner July 28, 2026 15:56
@netlify

netlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 387d7b6
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/6a68dbc38a4c990008a18e5c
😎 Deploy Preview https://deploy-preview-1839--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

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

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.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 919d73d1-1f54-4817-bacc-892773f43d12

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
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch whats-new-reorder-tsv2-beta

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

@Feediver1
Feediver1 requested a review from mattschumpert July 28, 2026 16:07
…properties

- Regenerate property partials from the v26.2.1 GA tag (diffed against
  v26.1.14). Adds reference entries for the 26.2 feature properties that
  were missing (kafka_fetch_read_coalescing_enabled,
  kafka_per_entity_quota_metrics, health_monitor_metrics_enabled, and
  others), fixing previously dangling anchors.
- Expand the What's New New configuration properties section from one
  property to all 29 new in 26.2, grouped by category.
- Fix the Tiered Storage v2 entry xref:
  default_redpanda_storage_mode_tiered_impl is documented on the object
  storage properties page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Feediver1

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved the merge conflicts from origin/beta in:

  • modules/reference/attachments/redpanda-properties-v26.1.14.json — restored correct default value, version tags, and three properties (schema_registry_enable_authorization, schema_registry_enable_qualified_subjects, schema_registry_replay_on_startup) that were clobbered during the merge, and fixed schema_registry_deferred_recovery visibility to tunable
  • modules/reference/partials/properties/cluster-properties.adoc — took the origin/beta side for all conflicts: updated log_eviction_exempt_topics (correct default, version tag, User visibility, related topics xref), schema_registry_deferred_recovery (Tunable visibility, version tag, no deprecated wrapper), and schema_registry_enable_qualified_subjects (corrected description sentence order)

Commit: docs: resolve merge conflicts from origin/beta

@JakeSCahill
JakeSCahill merged commit 6ff9eef into beta Jul 28, 2026
5 checks passed
@JakeSCahill
JakeSCahill deleted the whats-new-reorder-tsv2-beta branch July 28, 2026 16:57
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.

3 participants