From 0cb98ccd663cc65cf87206a6898d8751f3d847bb Mon Sep 17 00:00:00 2001 From: micheleRP Date: Wed, 11 Mar 2026 23:36:04 -0600 Subject: [PATCH 1/5] DOC-1825 Document Cloud Feature Cloud Topics --- local-antora-playbook.yml | 2 +- modules/ROOT/nav.adoc | 6 ++++-- modules/get-started/pages/cloud-topics.adoc | 4 ++++ modules/get-started/pages/topics-index.adoc | 3 +++ 4 files changed, 12 insertions(+), 3 deletions(-) create mode 100644 modules/get-started/pages/cloud-topics.adoc create mode 100644 modules/get-started/pages/topics-index.adoc diff --git a/local-antora-playbook.yml b/local-antora-playbook.yml index d8d478c8..70f8ee9a 100644 --- a/local-antora-playbook.yml +++ b/local-antora-playbook.yml @@ -15,7 +15,7 @@ content: - url: . branches: HEAD - url: https://github.com/redpanda-data/documentation - branches: [main, v/*, shared, site-search] + branches: [DOC-1602, main, v/*, shared, site-search] - url: https://github.com/redpanda-data/docs-site branches: [main] start_paths: [home] diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 60e12bce..535bceda 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -397,8 +397,10 @@ * xref:develop:index.adoc[Develop] ** xref:develop:kafka-clients.adoc[] -** xref:get-started:create-topic.adoc[Create a Topic] -** xref:get-started:config-topics.adoc[Manage Topics] +** xref:get-started:topics-index.adoc[Topics] +*** xref:get-started:create-topic.adoc[Create a Topic] +*** xref:get-started:config-topics.adoc[Manage Topics] +*** xref:get-started:cloud-topics.adoc[Manage Cloud Topics] ** xref:develop:produce-data/index.adoc[Produce Data] *** xref:develop:produce-data/configure-producers.adoc[] *** xref:develop:produce-data/idempotent-producers.adoc[Idempotent Producers] diff --git a/modules/get-started/pages/cloud-topics.adoc b/modules/get-started/pages/cloud-topics.adoc new file mode 100644 index 00000000..2a960774 --- /dev/null +++ b/modules/get-started/pages/cloud-topics.adoc @@ -0,0 +1,4 @@ += Manage Cloud Topics +:description: Cloud Topics are Redpanda topics that enable users to trade off latency for lower costs. + +include::ROOT:develop:manage-topics/cloud-topics.adoc[tag=single-source] diff --git a/modules/get-started/pages/topics-index.adoc b/modules/get-started/pages/topics-index.adoc new file mode 100644 index 00000000..7834f317 --- /dev/null +++ b/modules/get-started/pages/topics-index.adoc @@ -0,0 +1,3 @@ += Topics +:description: Learn how to create and manage topics in Redpanda Cloud, including standard topics and Cloud Topics. +:page-layout: index From 056f72281ead37e7fdfa92b1e2c7548d57e3feca Mon Sep 17 00:00:00 2001 From: micheleRP Date: Thu, 12 Mar 2026 00:05:26 -0600 Subject: [PATCH 2/5] move files & add aliases, consistent with docs repo --- modules/ROOT/nav.adoc | 8 ++++---- .../create-iceberg-sink-connector.adoc | 2 +- .../pages/topics}/cloud-topics.adoc | 0 .../pages/topics}/config-topics.adoc | 3 ++- .../pages/topics}/create-topic.adoc | 14 +++++++------- .../pages/topics/index.adoc} | 2 +- .../pages/cluster-types/serverless.adoc | 2 +- modules/get-started/pages/whats-new-cloud.adoc | 2 +- 8 files changed, 17 insertions(+), 16 deletions(-) rename modules/{get-started/pages => develop/pages/topics}/cloud-topics.adoc (100%) rename modules/{get-started/pages => develop/pages/topics}/config-topics.adoc (52%) rename modules/{get-started/pages => develop/pages/topics}/create-topic.adoc (83%) rename modules/{get-started/pages/topics-index.adoc => develop/pages/topics/index.adoc} (64%) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 535bceda..ac724f6a 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -397,10 +397,10 @@ * xref:develop:index.adoc[Develop] ** xref:develop:kafka-clients.adoc[] -** xref:get-started:topics-index.adoc[Topics] -*** xref:get-started:create-topic.adoc[Create a Topic] -*** xref:get-started:config-topics.adoc[Manage Topics] -*** xref:get-started:cloud-topics.adoc[Manage Cloud Topics] +** xref:develop:topics/index.adoc[Topics] +*** xref:develop:topics/create-topic.adoc[Create a Topic] +*** xref:develop:topics/config-topics.adoc[Manage Topics] +*** xref:develop:topics/cloud-topics.adoc[Manage Cloud Topics] ** xref:develop:produce-data/index.adoc[Produce Data] *** xref:develop:produce-data/configure-producers.adoc[] *** xref:develop:produce-data/idempotent-producers.adoc[Idempotent Producers] diff --git a/modules/develop/pages/managed-connectors/create-iceberg-sink-connector.adoc b/modules/develop/pages/managed-connectors/create-iceberg-sink-connector.adoc index 3c93a197..6f159327 100644 --- a/modules/develop/pages/managed-connectors/create-iceberg-sink-connector.adoc +++ b/modules/develop/pages/managed-connectors/create-iceberg-sink-connector.adoc @@ -22,7 +22,7 @@ Before you can create an Iceberg Sink connector in Redpanda Cloud, you must: . https://iceberg.apache.org/concepts/catalog/[Set up an Iceberg catalog^]. -. Create the Iceberg connector control topic, which cannot be used by other connectors. For details, see xref:get-started:create-topic.adoc[Create a Topic]. +. Create the Iceberg connector control topic, which cannot be used by other connectors. For details, see xref:develop:topics/create-topic.adoc[Create a Topic]. == Limitations diff --git a/modules/get-started/pages/cloud-topics.adoc b/modules/develop/pages/topics/cloud-topics.adoc similarity index 100% rename from modules/get-started/pages/cloud-topics.adoc rename to modules/develop/pages/topics/cloud-topics.adoc diff --git a/modules/get-started/pages/config-topics.adoc b/modules/develop/pages/topics/config-topics.adoc similarity index 52% rename from modules/get-started/pages/config-topics.adoc rename to modules/develop/pages/topics/config-topics.adoc index d076d716..c017739c 100644 --- a/modules/get-started/pages/config-topics.adoc +++ b/modules/develop/pages/topics/config-topics.adoc @@ -1,4 +1,5 @@ = Manage Topics :description: Learn how to create topics, update topic configurations, and delete topics or records. +:page-aliases: get-started:config-topics.adoc -include::ROOT:develop:config-topics.adoc[tag=single-source] \ No newline at end of file +include::ROOT:develop:config-topics.adoc[tag=single-source] diff --git a/modules/get-started/pages/create-topic.adoc b/modules/develop/pages/topics/create-topic.adoc similarity index 83% rename from modules/get-started/pages/create-topic.adoc rename to modules/develop/pages/topics/create-topic.adoc index 97b2b20a..68aa0d3e 100644 --- a/modules/get-started/pages/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -1,6 +1,6 @@ = Create a Topic :description: Learn how to create a topic for a Redpanda Cloud cluster. -:page-aliases: cloud:create-topic.adoc +:page-aliases: cloud:create-topic.adoc, get-started:create-topic.adoc @@ -22,27 +22,27 @@ include::develop:partial$topic-properties-warning.adoc[] | The number of partitions for the topic. | *Replication factor* -| The number of partition replicas for the topic. +| The number of partition replicas for the topic. -Redpanda Cloud requires a minimum of 3 topic replicas. If a topic is created with a replication factor of 1, Redpanda resets the replication factor to 3. +Redpanda Cloud requires a minimum of 3 topic replicas. If a topic is created with a replication factor of 1, Redpanda resets the replication factor to 3. | *Cleanup policy* -| The policy that determines how to clean up old log segments. +| The policy that determines how to clean up old log segments. The default is *delete*. | *Retention time* -| The maximum length of time to keep messages in a topic. +| The maximum length of time to keep messages in a topic. The default is *7 days*. | *Retention size* -| The maximum size of each partition. If a partition reaches this size and more messages are added, the oldest messages are deleted. +| The maximum size of each partition. If a partition reaches this size and more messages are added, the oldest messages are deleted. The default is *infinite*. | *Message size* -| The maximum size of a message or batch for a newly-created topic. +| The maximum size of a message or batch for a newly-created topic. The default is *20 MiB* for BYOC and Dedicated clusters, and *8 MiB* for Serverless clusters. You can increase this value up to *32 MiB* for BYOC and Dedicated clusters, and *20 MiB* for Serverless clusters, with the `message.max.bytes` topic property. |=== diff --git a/modules/get-started/pages/topics-index.adoc b/modules/develop/pages/topics/index.adoc similarity index 64% rename from modules/get-started/pages/topics-index.adoc rename to modules/develop/pages/topics/index.adoc index 7834f317..4b33c0d0 100644 --- a/modules/get-started/pages/topics-index.adoc +++ b/modules/develop/pages/topics/index.adoc @@ -1,3 +1,3 @@ = Topics -:description: Learn how to create and manage topics in Redpanda Cloud, including standard topics and Cloud Topics. +:description: Learn how to create and manage topics in Redpanda Cloud. :page-layout: index diff --git a/modules/get-started/pages/cluster-types/serverless.adoc b/modules/get-started/pages/cluster-types/serverless.adoc index 7277e5d9..a1922162 100644 --- a/modules/get-started/pages/cluster-types/serverless.adoc +++ b/modules/get-started/pages/cluster-types/serverless.adoc @@ -108,5 +108,5 @@ Not all features included in BYOC clusters are available in Serverless. For exam * xref:networking:serverless/aws/index.adoc[Set up private access for Serverless clusters] * xref:manage:terraform-provider.adoc[Manage Redpanda Cloud with Terraform] * xref:get-started:cloud-overview.adoc[Learn more about Redpanda Cloud] -* xref:get-started:config-topics.adoc[Manage topics] +* xref:develop:topics/config-topics.adoc[Manage topics] * xref:billing:billing.adoc[Learn about billing] \ No newline at end of file diff --git a/modules/get-started/pages/whats-new-cloud.adoc b/modules/get-started/pages/whats-new-cloud.adoc index 57432530..8abc2c7c 100644 --- a/modules/get-started/pages/whats-new-cloud.adoc +++ b/modules/get-started/pages/whats-new-cloud.adoc @@ -103,7 +103,7 @@ You can view details about Kafka client connections using `rpk` or the Data Plan === Increased message size limit -Redpanda Cloud increased the xref:get-started:create-topic.adoc[message size limit] on newly-created topics. BYOC and Dedicated clusters have a default message size limit of 20 MiB with a maximum of 32 MiB. Serverless clusters have a default message size limit of 8 MiB with a maximum of 20 MiB. Configure the message size limit with the `max_message_bytes` topic property. +Redpanda Cloud increased the xref:develop:topics/create-topic.adoc[message size limit] on newly-created topics. BYOC and Dedicated clusters have a default message size limit of 20 MiB with a maximum of 32 MiB. Serverless clusters have a default message size limit of 8 MiB with a maximum of 20 MiB. Configure the message size limit with the `max_message_bytes` topic property. The message size setting on existing topics is not changed, but the message size limit on existing topics can only be updated to the new maximum. From 5b69ca6030af2e50a8f817388965aca8957096ba Mon Sep 17 00:00:00 2001 From: micheleRP Date: Thu, 12 Mar 2026 09:02:16 -0600 Subject: [PATCH 3/5] Add Next steps section to create-topic.adoc and rename nav entry to Overview Co-Authored-By: Claude Opus 4.6 --- modules/ROOT/nav.adoc | 2 +- modules/develop/pages/topics/create-topic.adoc | 3 +++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index ac724f6a..777c4d7a 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -398,7 +398,7 @@ * xref:develop:index.adoc[Develop] ** xref:develop:kafka-clients.adoc[] ** xref:develop:topics/index.adoc[Topics] -*** xref:develop:topics/create-topic.adoc[Create a Topic] +*** xref:develop:topics/create-topic.adoc[Overview] *** xref:develop:topics/config-topics.adoc[Manage Topics] *** xref:develop:topics/cloud-topics.adoc[Manage Cloud Topics] ** xref:develop:produce-data/index.adoc[Produce Data] diff --git a/modules/develop/pages/topics/create-topic.adoc b/modules/develop/pages/topics/create-topic.adoc index 68aa0d3e..917b3aa9 100644 --- a/modules/develop/pages/topics/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -47,4 +47,7 @@ The default is *infinite*. The default is *20 MiB* for BYOC and Dedicated clusters, and *8 MiB* for Serverless clusters. You can increase this value up to *32 MiB* for BYOC and Dedicated clusters, and *20 MiB* for Serverless clusters, with the `message.max.bytes` topic property. |=== +== Next steps +* xref:develop:topics/config-topics.adoc[] +* xref:develop:topics/cloud-topics.adoc[] From 44b335037a1180a630236f6e2433047fe6e92a0c Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Thu, 12 Mar 2026 12:11:21 -0600 Subject: [PATCH 4/5] Update modules/develop/pages/topics/index.adoc Co-authored-by: Joyce Fee <102751339+Feediver1@users.noreply.github.com> --- modules/develop/pages/topics/index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/develop/pages/topics/index.adoc b/modules/develop/pages/topics/index.adoc index 4b33c0d0..5dd0ef4f 100644 --- a/modules/develop/pages/topics/index.adoc +++ b/modules/develop/pages/topics/index.adoc @@ -1,3 +1,3 @@ = Topics -:description: Learn how to create and manage topics in Redpanda Cloud. +:description: Overview of standard topics in Redpanda Cloud. :page-layout: index From 34a86c280bb9ffd74ef78f3794e81edfb7e76724 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Thu, 12 Mar 2026 12:13:40 -0600 Subject: [PATCH 5/5] incorporate doc review feedback --- modules/develop/pages/topics/create-topic.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/develop/pages/topics/create-topic.adoc b/modules/develop/pages/topics/create-topic.adoc index 917b3aa9..9bc83755 100644 --- a/modules/develop/pages/topics/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -1,4 +1,4 @@ -= Create a Topic += Topics Overview :description: Learn how to create a topic for a Redpanda Cloud cluster. :page-aliases: cloud:create-topic.adoc, get-started:create-topic.adoc