Page History

This page describes a proposed Kafka Improvement Proposal (KIP) process for proposing a major change to Kafka.

...

...

Getting Started

If this is your first time contributing:

1. Sign up for the Developer mailing list dev@kafka.apache.org . The instructions to sign up are here: http://kafka.apache.org/contact

...

2. Create a wiki ID (https://cwiki.apache.org/confluence/signup.action)
3. Create a Jira ID (It's a different system than the wiki) using the ASF Self-serve Portal (https://selfserve.apache.org/jira-account.html)
4. Send an email to the dev mailing list (dev@kafka.apache.org) containing your wiki ID and Jira ID requesting permissions to contribute to Apache Kafka.

Purpose

We want to make Kafka a core architectural component for users. We also support a large number of integrations with other tools, systems, and clients. Keeping this kind of usage health requires a high level of compatibility between releases — core architectural elements can't break compatibility or shift functionality from release to release. As a result each new major feature or public api has to be done in a way that we can stick with it going forward.

...

• Binary log format
• The network protocol and api behavior
• Any class for which the build generates Javadoc.  This includes (but is not limited to; look for javadoc {} sections in the public packages under clients build.gradle for the complete list):
  

  • org/apache/kafka/common/serialization

  • org/apache/kafka/common

  • org/apache/kafka/common/errors

  • org/apache/kafka/clients/producer

  • org/apache/kafka/clients/consumer (eventually, once stable)

• Configuration, especially client configuration
• Monitoring
• Command line tools and arguments

...

1. Click

   Create from template
   templateName 54329345 templateId 54329345 title KIP-NEXT: Insert Title Here buttonLabel Create KIP

   . Take the next available KIP number and give your proposal a descriptive heading. e.g. "KIP 42: Allow Infinite Retention With Bounded Disk Usage".
2. Update the next available KIP number below.
3. Fill in the sections as described above
4. Also add an entry to the table KIPs under discussion (for Streams API KIPs, please also add it to Kafka Streams sub page).
5. Start a [DISCUSS] thread on the Apache mailing list. Start a [DISCUSS] thread on the Apache mailing list. Please ensure that the subject of the thread is of the format [DISCUSS] KIP-{your KIP number} {your KIP heading} and the body contains a link to your new KIP. The discussion should happen on the mailing list, not on the wiki, since the wiki comment system doesn't work well for larger discussions. In the process of the discussion you may update the proposal. You should let people know the changes you are making. When you feel you have a finalized proposal 
6. Once the proposal is finalized call a [VOTE] to have the proposal adopted. These proposals are more serious than code changes and more serious even than release votes. The criteria for acceptance is lazy majority. The vote should remain open for at least 72 hours.
7. Please update the KIP wiki page, and the index below, to reflect the current stage of the KIP after a vote. This acts as the permanent record indicating the result of the KIP (e.g., Accepted or Rejected). Also report the result of the KIP vote to the voting thread on the mailing list so the conclusion is clear.e

KIP round-up

Next KIP Number: 4811033

Use this number as the identifier for your KIP and increment this value.

...

Please insert new rows in sorted order (descending by KIP number).

...

Please insert new rows in sorted order (by KIP number).

Dormant/inactive KIPs

Please insert new rows in sorted order (by KIP number).

...

Functionality can be realized with existing API although at a lower level. 

KIPs under discussion

Please insert new rows in sorted order (ascending by KIP number). Please move the adopted/accepted KIPs to the "Adopted KIPs" table above.

Go to link

Dormant/inactive KIPs

Please insert new rows in sorted order (ascending by KIP number).

Discarded KIPs

Please insert new rows in sorted order (ascending by KIP number).