doc: revisions - clarify reachability examples