robobario commented on code in PR #17967: URL: https://github.com/apache/kafka/pull/17967#discussion_r1870553518
########## docs/protocol.html: ########## @@ -143,7 +138,13 @@ <h5 class="anchor-heading"><a id="api_versions" class="anchor-link"></a><a href= Kafka protocol requests may take place on an SSL listener before the SSL handshake is finished). If this is considered to leak information about the broker version a workaround is to use SSL with client authentication which is performed at an earlier stage of the connection where the <code>ApiVersionRequest</code> is not available. Also, note that broker versions older - than 0.10.0.0 do not support this API and will either ignore the request or close connection in response to the request.</li> + than 0.10.0.0 do not support this API and will either ignore the request or close connection in response to the request. Also + note that if the client <code>ApiVersionsRequest</code> version is unsupported by the broker (client is ahead), and the broker + version is 2.5.0 or greater, then the broker will respond with a version 0 <a href="#The_Messages_ApiVersions">ApiVersionsResponse</a> Review Comment: I believe the comment is correct. I found 2.5.0 via the [2.5.0 release notes](https://archive.apache.org/dist/kafka/2.5.0/RELEASE_NOTES.html). This is because the JIRA ticket was partially implemented in 2.4.0 and finished in 2.5.0: ``` $ git log 2.5.0 --grep KIP-511 --oneline ae38315895 KAFKA-8855; Collect and Expose Client's Name and Version in the Brokers (KIP-511 Part 2) (#7749) f98013cc50 Part 1 of KIP-511: Collect and Expose Client's Name and Version in the Brokers #7381 $ git log 2.4.0 --grep KIP-511 --oneline f98013cc50 Part 1 of KIP-511: Collect and Expose Client's Name and Version in the Brokers #7381 ``` the relevant change to the ApiVersions response arrived in 2.4 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org