Update topic properties (#529)

* JK-8526: Update topic properties

* Last tweaks

Author: sterobin

docs/kafka/topic-configuration-kafka/README.adoc

@@ -164,7 +164,7 @@ Partitions are distinct lists of messages within a topic. Partitions are the mai
 [cols="25%,75%"]
 |===
 h|Editable
-|Yes (increase only)
+|Yes
 
 h|Type
 |Integer
@@ -173,7 +173,7 @@ h|Default value
 |`1`
 
 h|Supported values
-|[`1,...`]
+|1 or greater
 
 h|Kafka property name
 |`num.partitions`
@@ -205,6 +205,8 @@ h|Type
 h|Default value
 |`3`
 
+(For trial Kafka instances, the default value is `1`.)
+
 h|Kafka property name
 |`replication.factor`
 |===
@@ -227,6 +229,8 @@ h|Type
 h|Default value
 |`2`
 
+(For trial Kafka instances, the default value is `1`.)
+
 h|Kafka property name
 |`min.insync.replicas`
 |===
@@ -247,10 +251,7 @@ h|Type
 |Long
 
 h|Default value
-|`604800000 ms` (7 days)
-
-h|Supported values
-| `milliseconds`, `seconds`, `days`, `months`, `years`, `Unlimited`
+|`604800000` (milliseconds, 7 days)
 
 h|Kafka property name
 |`retention.ms`
@@ -272,10 +273,7 @@ h|Type
 |Long
 
 h|Default value
-|`Unlimited`
-
-h|Supported values
-| `bytes`, `kilobytes`, `megabytes`, `gigabytes`, `terabytes`, `Unlimited`
+|`-1` (no retention size limit)
 
 h|Kafka property name
 |`retention.bytes`
@@ -301,7 +299,7 @@ h|Type
 |Integer
 
 h|Default value
-|`1 MB`
+|`1048588` (bytes)
 
 h|Kafka property name
 |`max.message.bytes`
@@ -345,18 +343,17 @@ h|Type
 |Long
 
 h|Default value
-|`9223372036854775807 ms`
+|`9223372036854775807` (milliseconds)
 
 h|Kafka property name
 |`message.timestamp.difference.max.ms`
 |===
 --
 
-Compression type::
+Message format version::
 +
 --
-Compression type determines the final compression for the topic. The standard compression types are `gzip`, `snappy`, `lz4`, and `zstd`. Additional compression types include `Uncompressed`, which does not compress the topic, and `Producer`, which retains the original compression type set by the producer. By default, the compression type is set to `Producer`.
-
+Message format version is the `ApiVersion` value that the broker uses to append messages to topics. This value must be a valid `ApiVersion` value, such as 0.10.0, 1.1, 2.8, or 3.0.
 
 .Property attributes
 [cols="25%,75%"]
@@ -368,18 +365,40 @@ h|Type
 |String
 
 h|Default value
-|`Producer`
+|`3.0-IV1`
 
 h|Kafka property name
-|`compression.type`
+|`message.format.version`
 |===
 --
 
+Message down-conversion::
++
+--
+Message down-conversion determines whether the broker can convert the `message.format.version` property value to an older version for consumers that require an older message format version. By default, this property is enabled in order to avoid an `UNSUPPORTED_VERSION` error for consumption requests from older clients. If this property adds excessive load to your broker, you can disable it.
 
-Message format version::
+.Property attributes
+[cols="25%,75%"]
+|===
+h|Editable
+|Yes
+
+h|Type
+|Boolean
+
+h|Default value
+|`true`
+
+h|Kafka property name
+|`message.downconversion.enable`
+|===
+--
+
+Compression type::
 +
 --
-Message format version is the `ApiVersion` value that the broker uses to append messages to topics. This value must be a valid `ApiVersion` value, such as 0.8.2, 0.9.0.0, or 0.10.0.
+Compression type determines the final compression for the topic. The standard compression types are `gzip`, `snappy`, `lz4`, and `zstd`. Additional compression types include `Uncompressed`, which does not compress the topic, and `Producer`, which retains the original compression type set by the producer. By default, the compression type is set to `Producer`.
+
 
 .Property attributes
 [cols="25%,75%"]
@@ -391,14 +410,13 @@ h|Type
 |String
 
 h|Default value
-|`2.7-IV2`
+|`Producer`
 
 h|Kafka property name
-|`message.format.version`
+|`compression.type`
 |===
 --
 
-
 === Log
 
 These properties define how your log is handled.
@@ -439,13 +457,13 @@ Delete retention time is the amount of time that deletion tombstone markers are
 [cols="25%,75%"]
 |===
 h|Editable
-|No
+|Yes
 
 h|Type
 |Long
 
 h|Default value
-|`86400000 ms` (1 day)
+|`86400000` (milliseconds, 1 day)
 
 h|Kafka property name
 |`delete.retention.ms`
@@ -483,19 +501,41 @@ Minimum compaction lag time is the minimum time a message remains uncompacted in
 [cols="25%,75%"]
 |===
 h|Editable
-|No
+|Yes
 
 h|Type
 |Long
 
 h|Default value
-|`0 seconds`
+|`0` (milliseconds)
 
 h|Kafka property name
 |`min.compaction.lag.ms`
 |===
 --
 
+Maximum compaction lag time::
++
+--
+Maximum compaction lag time is the maximum time a message remains uncompacted in a log. This property applies only when the topic cleanup policy is set to `Compact` or `Compact, Delete`.
+
+.Property attributes
+[cols="25%,75%"]
+|===
+h|Editable
+|Yes
+
+h|Type
+|Long
+
+h|Default value
+|`9223372036854775807` (milliseconds)
+
+h|Kafka property name
+|`max.compaction.lag.ms`
+|===
+--
+
 === Replication
 
 These properties control the behavior of your replicas. Each of these properties impacts every replica created in the topic.
@@ -515,7 +555,7 @@ h|Type
 |Boolean
 
 h|Default value
-|`Disabled`
+|`false`
 
 h|Kafka property name
 |`unclean.leader.election.enable`
@@ -535,13 +575,16 @@ Log segment size is the size of the log segment files that constitute the log. L
 [cols="25%,75%"]
 |===
 h|Editable
-|No
+|Yes
 
 h|Type
 |Integer
 
 h|Default value
-|`1 GB`
+|`1073741824` (bytes)
+
+h|Supported values
+| 52428800 bytes or greater
 
 h|Kafka property name
 |`segment.bytes`
@@ -557,13 +600,16 @@ Segment time is the amount of time after which the current log segment is rolled
 [cols="25%,75%"]
 |===
 h|Editable
-|No
+|Yes
 
 h|Type
 |Long
 
 h|Default value
-|`604800000 ms` (7 days)
+|`604800000` (milliseconds, 7 days)
+
+h|Supported values
+|600000 ms (10 mins) or greater
 
 h|Kafka property name
 |`segment.ms`
@@ -585,7 +631,7 @@ h|Type
 |Long
 
 h|Default value
-|`0 seconds`
+|`0` (milliseconds)
 
 h|Kafka property name
 |`segment.jitter.ms`
@@ -607,7 +653,7 @@ h|Type
 |Long
 
 h|Default value
-|`60000 ms` (1 minute)
+|`60000` (milliseconds, 1 minute)
 
 h|Kafka property name
 |`file.delete.delay.ms`
@@ -629,7 +675,7 @@ h|Type
 |Boolean
 
 h|Default value
-|`Disabled`
+|`false`
 
 h|Kafka property name
 |`preallocate`
@@ -655,7 +701,7 @@ h|Type
 |Integer
 
 h|Default value
-|`4 KB`
+|`4000` (bytes, 4 KB)
 
 h|Kafka property name
 |`index.interval.bytes`
@@ -677,7 +723,7 @@ h|Type
 |Integer
 
 h|Default value
-|`10 MB`
+|`10485760` (bytes)
 
 h|Kafka property name
 |`segment.index.bytes`
@@ -703,7 +749,7 @@ h|Type
 |Long
 
 h|Default value
-|`9223372036854775807 messages`
+|`9223372036854775807` (messages)
 
 h|Kafka property name
 |`flush.messages`
@@ -725,7 +771,7 @@ h|Type
 |Long
 
 h|Default value
-|`9223372036854775807 ms`
+|`9223372036854775807` (milliseconds)
 
 h|Kafka property name
 |`flush.ms`