diff --git a/local-antora-playbook.yml b/local-antora-playbook.yml index d8d478c82..70f8ee9ab 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 5e4bd59cb..d94f85ba1 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -398,8 +398,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:develop:topics/index.adoc[Topics] +*** 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] *** 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 3c93a197c..6f1593276 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/develop/pages/topics/cloud-topics.adoc b/modules/develop/pages/topics/cloud-topics.adoc new file mode 100644 index 000000000..2a9607748 --- /dev/null +++ b/modules/develop/pages/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] 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 d076d716a..c017739c9 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 77% rename from modules/get-started/pages/create-topic.adoc rename to modules/develop/pages/topics/create-topic.adoc index 97b2b20aa..9bc837556 100644 --- a/modules/get-started/pages/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -1,6 +1,6 @@ -= Create a Topic += Topics Overview :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,29 +22,32 @@ 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. |=== +== Next steps +* xref:develop:topics/config-topics.adoc[] +* xref:develop:topics/cloud-topics.adoc[] diff --git a/modules/develop/pages/topics/index.adoc b/modules/develop/pages/topics/index.adoc new file mode 100644 index 000000000..5dd0ef4f4 --- /dev/null +++ b/modules/develop/pages/topics/index.adoc @@ -0,0 +1,3 @@ += Topics +:description: Overview of standard 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 7277e5d98..a1922162e 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 69c095763..7ba1a0349 100644 --- a/modules/get-started/pages/whats-new-cloud.adoc +++ b/modules/get-started/pages/whats-new-cloud.adoc @@ -104,7 +104,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.