Skip to content

Conversation

@micheleRP
Copy link
Contributor

@micheleRP micheleRP commented Sep 19, 2025

Description

This pull request updates documentation to reflect that automatic topic creation is now enabled in Redpanda Cloud.

  • Added a new section in modules/get-started/pages/whats-new-cloud.adoc announcing that you can enable automatic topic creation for BYOC and Dedicated clusters. All clusters now have a 40,000 topic limit
  • Updated note from modules/get-started/pages/cloud-overview.adoc about automatic topic creation
  • Added auto_create_topics_enabled cluster property to reference
  • Updated Create a Topic and Manage Topics pages with 40,000 topic limit

Single sourcing done in redpanda-data/docs#1361

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

Page previews

What's New
Cluster Configuration Properties
Cloud Overview
Create a Topic
Manage Topics

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 September 19, 2025 00:29
@netlify
Copy link

netlify bot commented Sep 19, 2025

Deploy Preview for rp-cloud ready!

Name Link
🔨 Latest commit 0875eda
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/68d2d76e4b54310008daa4d4
😎 Deploy Preview https://deploy-preview-418--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
Copy link
Contributor

coderabbitai bot commented Sep 19, 2025

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.

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

📝 Walkthrough

Walkthrough

Documentation updates across three pages:

  • cloud-overview.adoc: Removed detailed unsupported functionality list and topic-creation note; added a note that rpk cloud commands are not supported in Self-Managed deployments; clarified managed nature and rollout behavior for features.
  • serverless.adoc: Removed a note about opinionated Kafka configs and disabled topic auto-creation; added AWS region placement guidance in two sections.
  • whats-new-cloud.adoc: Added a “Automatic topic creation” entry under September 2025 (Redpanda Cloud MCP Server: beta), describing that automatic topic creation is now enabled in Redpanda Cloud.

Sequence Diagram(s)

sequenceDiagram
    autonumber
    actor Producer as Client Producer
    participant Kafka as Redpanda Cloud Kafka API
    participant Controller as Cluster Controller
    participant Storage as Log Storage

    Producer->>Kafka: Produce to Topic T
    Kafka->>Kafka: Check metadata for T
    alt Topic T exists
        Kafka->>Storage: Append message to T
        Storage-->>Kafka: Ack append
        Kafka-->>Producer: Produce ack
    else Topic T missing
        Kafka->>Controller: Request auto-create Topic T
        Controller-->>Kafka: Topic T created
        Kafka->>Storage: Append message to T
        Storage-->>Kafka: Ack append
        Kafka-->>Producer: Produce ack
    end

    note over Kafka,Controller: Automatic topic creation enabled in Redpanda Cloud
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • david-yu
  • kbatuigas
  • Feediver1

Pre-merge checks and finishing touches

❌ Failed checks (2 warnings)
Check name Status Explanation Resolution
Linked Issues Check ⚠️ Warning The changes correctly document automatic topic creation (adds a whats-new note and removes outdated "auto-creation disabled" warnings), which aligns with part of DOC-1608, but the linked issue also requests documenting the "topic count clamp" exposure and there is no evidence in the modified files or PR description that the topic count clamp is documented here, so the PR only partially satisfies the linked-issue objectives. Either add documentation for the topic count clamp in this PR (or point to existing docs and cite them in the PR) and update the PR description to state which linked-issue objectives are completed, or update the linked issue to reflect that only auto-topic-creation is being covered here.
Out of Scope Changes Check ⚠️ Warning The PR contains additional edits that appear outside the core objective of documenting auto-topic-creation, specifically duplicate AWS region guidance added in modules/get-started/pages/cluster-types/serverless.adoc and the added "rpk cloud" unsupported note plus the collapsed/self-managed unsupported-features list in modules/get-started/pages/cloud-overview.adoc; these changes should be justified or separated because they are not explicitly referenced in the linked issue. Either document the rationale for the region-guidance and self-managed/rpk edits in the PR description (explaining why they are needed for the auto-topic-creation rollout) or remove/split those unrelated edits into a separate PR so this change remains focused on the linked issue.
✅ Passed checks (3 passed)
Check name Status Explanation
Title Check ✅ Passed The PR title "DOC-1608 auto topic creation in cloud" is concise, directly references the main change (automatic topic creation in Redpanda Cloud), and includes the issue identifier, making it easy for reviewers to understand the primary intent at a glance.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
Description Check ✅ Passed The PR description is specific and actionable: it explains the change (automatic topic creation enabled in Redpanda Cloud), lists affected files and page previews, and references the tracking ticket (Jira DOC-1608) and related single-sourcing PR; the Description, Page previews, and Checks sections are present and populated. However, it does not include the repository-specific "Resolves https://github.com/redpanda-data/documentation-private/issues/..." link required by the template and the "Review deadline" field is left blank. Overall the content is mostly complete and clear, but it misses the template's required GitHub-issue linkage and an explicit review deadline.

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

Copy link
Contributor

@paulohtb6 paulohtb6 left a comment

Choose a reason for hiding this comment

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

lgtm

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (4)
modules/get-started/pages/whats-new-cloud.adoc (2)

19-22: Clarify scope, rollout, and limits for auto topic creation.

State whether this applies to Serverless, Dedicated, and BYOC, and note the rollout behavior for existing clusters. Also reference the topic count clamp and defaults so users understand constraints and how to tune them.

 === Automatic topic creation
-
-Automatic topic creation is now enabled in Redpanda Cloud, so the Kafka service can automatically create topics when a message is produced to a topic that doesn't exist.
+Automatic topic creation is now enabled in Redpanda Cloud. When a client produces to a non‑existent topic, the topic is created automatically.
+
+This applies to Serverless, Dedicated, and BYOC clusters. New clusters have this behavior immediately; existing clusters gain it as they are upgraded to the latest version.
+
+Auto‑created topics use cluster defaults (for example, partitions and replication factor). See xref:reference:properties/cluster-properties.adoc[Cluster properties] for defaults and how to adjust them. Cloud‑level safeguards such as a topic count clamp may limit creation; contact Support if you need higher limits.

21-21: Use “Kafka API” for consistency.

Elsewhere we use “Kafka API” rather than “Kafka service.”

-Automatic topic creation is now enabled in Redpanda Cloud, so the Kafka service can automatically create topics when a message is produced to a topic that doesn't exist.
+Automatic topic creation is now enabled in Redpanda Cloud, so the Kafka API can automatically create topics when a message is produced to a topic that does not exist.
modules/get-started/pages/cloud-overview.adoc (2)

338-338: Mention rollout nuance to set expectations.

Small addition helps align with what’s-new and avoids implying instantaneous enablement everywhere.

-Because Redpanda Cloud is a fully-managed service that provides maintenance, data and partition balancing, upgrades, and recovery, much of the cluster maintenance required for Self-Managed users is not necessary for Redpanda Cloud users. New clusters in Redpanda Cloud generally include functionality added in Self-Managed versions immediately. Existing clusters include new functionality when they get upgraded to the latest version. 
+Because Redpanda Cloud is a fully-managed service that provides maintenance, data and partition balancing, upgrades, and recovery, much of the cluster maintenance required for Self-Managed users is not necessary for Redpanda Cloud users. New clusters in Redpanda Cloud generally include functionality added in Self-Managed versions immediately. Existing clusters include new functionality when they get upgraded to the latest version as part of normal maintenance windows.

338-340: Cross-link to the announcement for discoverability.

Light internal link improves navigation from overview to details.

 Existing clusters include new functionality when they get upgraded to the latest version as part of normal maintenance windows.
+For recent changes, see xref:get-started:whats-new-cloud.adoc[What’s New in Redpanda Cloud] (for example, automatic topic creation).
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Jira integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 2ac2182 and 74005be.

📒 Files selected for processing (3)
  • modules/get-started/pages/cloud-overview.adoc (1 hunks)
  • modules/get-started/pages/cluster-types/serverless.adoc (0 hunks)
  • modules/get-started/pages/whats-new-cloud.adoc (1 hunks)
💤 Files with no reviewable changes (1)
  • modules/get-started/pages/cluster-types/serverless.adoc
🧰 Additional context used
🧠 Learnings (3)
📓 Common learnings
Learnt from: micheleRP
PR: redpanda-data/cloud-docs#267
File: modules/manage/pages/maintenance.adoc:91-92
Timestamp: 2025-04-25T01:41:57.162Z
Learning: The notification timeline for Redpanda Cloud deprecations has been deliberately removed from the documentation, even though the PR summary mentioned a 180-day advance notice period.
Learnt from: micheleRP
PR: redpanda-data/cloud-docs#267
File: modules/manage/pages/maintenance.adoc:63-64
Timestamp: 2025-04-25T01:42:09.318Z
Learning: The timeline for major upgrade notifications (180 days in advance) was intentionally removed from the Redpanda Cloud maintenance documentation, even though it was mentioned in the PR objectives.
📚 Learning: 2025-04-25T01:41:57.162Z
Learnt from: micheleRP
PR: redpanda-data/cloud-docs#267
File: modules/manage/pages/maintenance.adoc:91-92
Timestamp: 2025-04-25T01:41:57.162Z
Learning: The notification timeline for Redpanda Cloud deprecations has been deliberately removed from the documentation, even though the PR summary mentioned a 180-day advance notice period.

Applied to files:

  • modules/get-started/pages/cloud-overview.adoc
📚 Learning: 2025-04-25T01:42:09.318Z
Learnt from: micheleRP
PR: redpanda-data/cloud-docs#267
File: modules/manage/pages/maintenance.adoc:63-64
Timestamp: 2025-04-25T01:42:09.318Z
Learning: The timeline for major upgrade notifications (180 days in advance) was intentionally removed from the Redpanda Cloud maintenance documentation, even though it was mentioned in the PR objectives.

Applied to files:

  • modules/get-started/pages/cloud-overview.adoc
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: Redirect rules - rp-cloud
  • GitHub Check: Header rules - rp-cloud
  • GitHub Check: Pages changed - rp-cloud
🔇 Additional comments (1)
modules/get-started/pages/whats-new-cloud.adoc (1)

19-22: Repo-wide sanity check for stale "auto topic creation is disabled" warnings

Automated search failed — run this locally and paste any matches:

git grep -n -i -E 'auto(-|[[:space:]])?create(ion)?([[:space:]])?topic(s)?.*(disable|disabled|not (enabled|supported|available|allowed))|automatic topic creation.*(disable|disabled|not (enabled|supported|available|allowed))' || true

Copy link

@ballard26 ballard26 left a comment

Choose a reason for hiding this comment

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

LGTM

@micheleRP
Copy link
Contributor Author

@travisdowns would you please confirm that this topic limit is now enforced for all clusters?

@travisdowns
Copy link
Member

@micheleRP it is enforced for all 25.2 and later version clusters, but not 25.1 or earlier. There should be very few 25.1 clusters around, but that would be a quesiton for the cloud team, asked here:

https://redpandadata.slack.com/archives/C0191NM4WU9/p1758640209193899

@micheleRP micheleRP merged commit 006534c into main Sep 23, 2025
5 checks passed
@micheleRP micheleRP deleted the DOC-1608-Document-Cloud-Feature-Finish-Rollout-topic-count-clamp-and-auto-topic-creation-in-cloud branch September 23, 2025 17:28
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.

6 participants