THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Status
Current state: Draft
Discussion thread:
JIRA:
Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).
Motivation
In a number of places our code uses racially charged terms such as "blacklist" and "whitelist". This is a proposal to replace them with neutral terms such as "blocklist" and "allowlist".
This follows the model other open source projects set forth, such as https://chromium.googlesource.com/chromium/src/+/master/styleguide/inclusive_code.md#racially-neutral
Public Interfaces
Affected configurations and command line arguments will be renamed. The old name will continue to be supported for backwards compatibility, but deprecated.
List of affected configurations
| component | type | existing | new config |
|---|---|---|---|
| JmxReporter | config | metrics.jmx.blacklist | metrics.jmx.blocklist |
| JmxReporter | config | metrics.jmx.whitelist | metrics.jmx.allowlist |
| MirrorMaker 2 | config | topics.blacklist | topics.blocklist |
| MirrorMaker 2 | config | groups.blacklist | groups.blocklist |
| MirrorMaker 2 | config | config.properties.blacklist | config.properties.blocklist |
kafka-mirror-maker CLI | command line argument | --whitelist | --allowlist |
| Kafka Connect Transforms | config | blacklist | blocklist |
| Kafka Connect Transforms | config | whitelist | allowlist |
| kafka-console-consumer CLI | command line argument | --whitelist | --allowlist |
kafka-replica-verification CLI | command line argument | --topic-white-list | --topic-allow-list |
Proposed Changes
In addition to the public interface changes above, internal APIs and other occurrences in code (e.g. method, variable names, comments, and log messages) will be updated accordingly.
Compatibility, Deprecation, and Migration Plan
Existing configuration names will be deprecated but will continue to work for backwards compatibility.
Rejected Alternatives
N/A