am bb536096: Merge "Improved documentation (clarify on issue 8727)"

* commit 'bb5360966668ca8e97c02363b0d87dc9c9ae2451':
  Improved documentation (clarify on issue 8727)