Explain idempotent producer in max.in.flight.requests.per.connection

A user asked:

Is the idempotent producer also a total order producer? meaning, despite having max.inflight > 1, it will keep message production ordering? My understanding of this has always been no, but I'd like to confirm...

A contributing factor to the confusion around this scenario is that https://kafka.apache.org/documentation/#max.in.flight.requests.per.connection reads

Note that if this setting is set to be greater than 1 and there are failed sends, there is a risk of message re-ordering due to retries (i.e., if retries are enabled).

Suggestion: it may be clearer if we augmented this description to say that message re-ordering would not happen if enable.idempotent=true