Ewen Cheslack-Postava created KAFKA-6009:
--------------------------------------------

             Summary: Fix formatting of autogenerated docs tables
                 Key: KAFKA-6009
                 URL: https://issues.apache.org/jira/browse/KAFKA-6009
             Project: Kafka
          Issue Type: Sub-task
          Components: documentation
            Reporter: Ewen Cheslack-Postava


In reviewing https://github.com/apache/kafka/pull/3987 I noticed that the 
autogenerated tables currently differ from the manually created ones. The 
manual ones have 3 columns -- metric/attribute name, description, and mbean 
name with a regex. The new ones have 3 columns, but for some reason the first 
one is just empty, the second is the metric/attribute name, the last one is the 
description, and there is no regex.

We could potentially just drop to two columns since the regex column is 
generally very repetitive and is now handled by a header row giving the general 
group mbean name info/format. The one thing that seems to currently be missing 
is the regex that would restrict the format of these (although these weren't 
really technically enforced and some of the restrictions are being removed, 
e.g. see some of the follow up discussion to 
https://cwiki.apache.org/confluence/display/KAFKA/KIP-190%3A+Handle+client-ids+consistently+between+clients+and+brokers).



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

Reply via email to