DOCS-1602: Cloud Topics

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, v/*, shared, site-search]
   - url: https://github.com/redpanda-data/docs-site
     branches: [main]
     start_paths: [home]

modules/ROOT/nav.adoc

@@ -397,8 +397,9 @@
 
 * 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:config-topics.adoc[Manage Topics]
+*** xref:develop:manage-topics/cloud-topics.adoc[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]

modules/develop/pages/manage-topics/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]

modules/get-started/pages/config-topics.adoc

@@ -1,4 +1,50 @@
 = Manage Topics
 :description: Learn how to create topics, update topic configurations, and delete topics or records.
+:page-aliases: cloud:create-topic.adoc
 
-include::ROOT:develop:config-topics.adoc[tag=single-source]
+== Create a Topic
+
+Topics provide a way to organize events. After creating a cluster, you can create a topic in it. Each cluster can have up to 40,000 topics.
+
+Topic properties are populated from information stored in the broker. Redpanda features, such as Tiered Storage, are enabled and configured by default in Redpanda Cloud. You can optionally overwrite some settings.
+
+include::develop:partial$topic-properties-warning.adoc[]
+
+++++
+<br>
+++++
+
+[cols="1,2"]
+|===
+| Property | Description
+
+| *Partitions*
+| The number of partitions for the topic.
+
+| *Replication factor*
+| 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.
+
+| *Cleanup policy*
+| 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 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 default is *infinite*.
+
+| *Message size*
+| 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.
+|===
+
+include::ROOT:develop:manage-topics/config-topics.adoc[tag=single-source]

modules/get-started/pages/topics-index.adoc

@@ -0,0 +1,6 @@
+= Topics
+:description: Create and configure standard Redpanda topics, or use Cloud Topics for high-throughput, cost-optimized workloads that trade latency for lower storage costs.
+
+* xref:get-started:config-topics.adoc[Manage Topics] — Learn how to create topics, update topic configurations, and delete topics or records.
+
+* xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics] — Use Cloud Topics when you require low-cost, high-throughput streaming storage for applications with flexible latency requirements.