[
https://issues.apache.org/jira/browse/KAFKA-9423?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17014995#comment-17014995
]
Sönke Liebau commented on KAFKA-9423:
-------------------------------------
Personally I am in favor of one of the options that list options vertically (1
& 3).
If we have the specifications on one line, we risk running out of horizontal
space again for example if a setting has a very long default value.
> Refine layout of configuration options on website and make individual
> settings directly linkable
> ------------------------------------------------------------------------------------------------
>
> Key: KAFKA-9423
> URL: https://issues.apache.org/jira/browse/KAFKA-9423
> Project: Kafka
> Issue Type: Improvement
> Components: documentation
> Reporter: Sönke Liebau
> Assignee: Sönke Liebau
> Priority: Trivial
> Attachments: option1.png, option2.png, option3.png, option4.png
>
>
> KAKFA-8474 changed the layout of configuration options on the website from a
> table which over time ran out of horizontal space to a list.
> This vastly improved readability but is not yet ideal. Further discussion was
> had in the [PR|https://github.com/apache/kafka/pull/6870] for KAFKA-8474.
> This ticket is to move that discussion to a separate thread and make it more
> visible to other people and to give subsequent PRs a home.
> Currently proposed options are attached to this issue.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
