Fixes https://github.com/spring-projects/spring-integration/issues/8659
* GH-8659: Updating the documentation as requested
* GH-8659: Fixes requested after coder review
**Cherry-pick to `6.1.x`, `6.0.x` & `5.5.x`**
(cherry picked from commit 0798c8df95)