Update the prose to match the revised API, and to tighten up the language in some places.
Update the prose to match the revised API, and to tighten up the language in some places.

abertelrud/swift-evolution,apple/swift-evolution,natecook1000/swift-evolution,apple/swift-evolution,abertelrud/swift-evolution,natecook1000/swift-evolution