code review suggestions

Author: paulohtb6

modules/manage/pages/cluster-maintenance/topic-property-configuration.adoc

@@ -21,12 +21,49 @@ You can configure topic properties through multiple interfaces:
 
 == Verify topic property configuration
 
-The `SOURCE` output of the xref:reference:rpk/rpk-topic/rpk-topic-describe.adoc[`rpk topic describe <topic>`] command shows how properties are configured for the topic:
+Use `rpk topic describe <topic>` to view topic properties and their configuration sources:
 
-* `DEFAULT_CONFIG` is set by a Redpanda default.
-* `DYNAMIC_TOPIC_CONFIG` is set by the user specifically for the topic and overrides inherited default configurations, such as a default or a cluster-level property.
+```
+rpk topic describe my-topic
+```
+
+The output shows two sections:
+
+```
+SUMMARY
+=======
+NAME        my-topic
+PARTITIONS  1
+REPLICAS    1
+
+CONFIGS
+=======
+KEY                     VALUE          SOURCE
+cleanup.policy          delete         DEFAULT_CONFIG
+compression.type        producer       DEFAULT_CONFIG
+retention.ms            604800000      DEFAULT_CONFIG
+write.caching           true           DYNAMIC_TOPIC_CONFIG
+```
+
+The `SOURCE` column indicates how each property is configured:
+
+* `DEFAULT_CONFIG` - Redpanda's default value
+* `DYNAMIC_TOPIC_CONFIG` - User-configured value
 
-Although xref:reference:rpk/rpk-topic/rpk-topic-describe.adoc[`rpk topic describe`] doesn't report `replication.factor` as a configuration, `replication.factor` can indeed be set by using the xref:reference:rpk/rpk-topic/rpk-topic-alter-config.adoc[`rpk topic alter-config`] command.
+The replication factor appears as REPLICAS in the SUMMARY section, not as replication.factor in the CONFIGS list. However, you need to use the `replication.factor` key when modifying the value with `rpk topic alter-config`.
+
+For partition-level details, add the `-p` flag:
+
+```
+rpk topic describe my-topic -p
+```
+
+This shows a different output focused on partition information:
+
+```
+PARTITION  LEADER  EPOCH  REPLICAS  LOG-START-OFFSET  HIGH-WATERMARK
+0          0       1      [0]       0                 0
+```
 
 == Examples