hi Kafka There is a section[1] listing the packages which have public interfaces. However, it doesn't include any connect-related packages. It would be better to have a list used to highlight the public interfaces for connector. Otherwise, connector user may misuse the internal interface in their code base. For example, TopicAdmin[2] is a nice wrap of AdminClient[3] so I have applied TopicAdmin in production code. However, I'm not sure whether TopicAdmin is a public interface. It implies that I should remove it from code base since the SC of TopicAdmin may be broken in minor release.
Not familiar with the rule of updating "Kafka Improvement Proposals" so I start this thread. All suggestions are welcome! [1] https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Improvement+Proposals#KafkaImprovementProposals-Whatisconsidereda%22majorchange%22thatneedsaKIP? [2] https://github.com/apache/kafka/blob/trunk/connect/runtime/src/main/java/org/apache/kafka/connect/util/TopicAdmin.java [3] https://github.com/apache/kafka/blob/trunk/clients/src/main/java/org/apache/kafka/clients/admin/AdminClient.java -- Chia-Ping
