[
https://issues.apache.org/jira/browse/KAFKA-9650?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17087696#comment-17087696
]
ASF GitHub Bot commented on KAFKA-9650:
---------------------------------------
tombentley commented on issue #8222:
URL: https://github.com/apache/kafka/pull/8222#issuecomment-616538532
@mimaison I rewrote that code, which I think makes it clear enough and
avoids the repeated constants.
Rendered it looks like this:
I wasn't too sure about the `=` in parens, but I thought it made it clearer
that it wasn't part of the default value. I guess an alternative would be to
use some other font, or italics to make that clear.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
> 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
> Priority: Trivial
>
> 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)
