[ 
https://issues.apache.org/jira/browse/KAFKA-21206?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18123084#comment-18123084
 ] 

Chia-Ping Tsai commented on KAFKA-21206:
----------------------------------------

I just noticed that {{RemoteLogMetadataFormatter}} is located in the 
{{storage}} module rather than the {{tools}} module. If we plan to showcase 
these formatters in the documentation, I'm wondering if we need a KIP to 
discuss the following items:
 # Move {{RemoteLogMetadataFormatter}} to the {{tools}} module with a 
backward-compatible approach (e.g., keeping a deprecated alias in 
{{{}storage{}}}).

 # Clarify/declare whether these internal record formatters (and their FQCNs) 
are officially considered Public APIs.

WDYT?

> Enhance the docs of --formatter to showcase the available formatters
> --------------------------------------------------------------------
>
>                 Key: KAFKA-21206
>                 URL: https://issues.apache.org/jira/browse/KAFKA-21206
>             Project: Kafka
>          Issue Type: Improvement
>            Reporter: Chia-Ping Tsai
>            Assignee: Ziyun Fu
>            Priority: Minor
>
> There are many formatters which can parse the internal records, but we don't 
> have any documentation for them. At the very least, we should list them in 
> the help text of {{--formatter}} ({{{}messageFormatterOpt{}}}), and mention 
> that {{exclude.internal.topics=false}} is required when reading internal 
> topics.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to