You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@kafka.apache.org by "Tom Bentley (Jira)" <ji...@apache.org> on 2020/03/04 17:00:00 UTC

[jira] [Created] (KAFKA-9650) Include human readable quantities for default config docs

Tom Bentley created KAFKA-9650:
----------------------------------

             Summary: Include human readable quantities for default config docs
                 Key: KAFKA-9650
                 URL: https://issues.apache.org/jira/browse/KAFKA-9650
             Project: Kafka
          Issue Type: Improvement
          Components: docs
            Reporter: Tom Bentley
            Assignee: Tom Bentley


The Kafka config docs include default values for quantities in milliseconds and bytes, for example {{log.segment.bytes}} has default: {{1073741824}}. Many readers won't know that that's 1GiB, so will have to work it out. It would make the docs more readable if we included the quantity in the appropriate unit in parenthesis after the actual default value, like this:

default: 1073741824 (=1GiB)

Similarly for values in milliseconds. 



--
This message was sent by Atlassian Jira
(v8.3.4#803005)