[docs] Incorprate first round of feedback on D114325

This builds on the text landed in 73d52ee7, and incorporates the points that Renato brought up.

Differential Revision: https://reviews.llvm.org/D114325