[Protocol] Add guidance to send CloseProducer before sending Producer…

[michaeljmarshall]

… in case of client side timeout

Motivation

As discussed on the mailing list here, https://lists.apache.org/thread/tko0z4jg0oq0yf931rbow2zf9fq8wjt1, it is most ideal for the client to send a CloseProducer command before sending a subsequent Producer command when the client timeouts out the original Producer request.

This PR updates the protocol documentation. I will submit a PR to update the Java client once this PR is merged.

Modifications

• Update current docs for protocol
• Update next docs for protocol

Verifying this change

This is just a change to documentation.

Does this pull request potentially affect one of the following parts:

• Dependencies (does it add or upgrade a dependency): no
• The public API: no
• The schema: no
• The default values of configurations: no
• The wire protocol: yes
• The rest endpoints: no
• The admin cli options: no
• Anything that affects deployment: no

Regarding the change to the wire protocol, this is simply an expansion on a currently ambiguous portion of the protocol. I've discussed this change on the mailing list.

Documentation

• doc

[Anonymitaet]

Thanks a lot for adding docs! LGTM from a technical writing perspective.

[Anonymitaet]

@codelipenghui can you review it from the technical perspective? Thanks

[lhotari]

LGTM