Wrong example in change record

In this change record, the example with allowedIf() is actually wrong, I think. Since the AccessResultAllowed class doesn't have a setReason() method, the example code would lead to a fatal error whenever access is allowed.
Instead maybe something like this:

$access = AccessResult::allowedIf($account->hasPermission('access comments') && $entity->isPublished())
      ->cachePerPermissions()
      ->addCacheableDependency($entity);
    if ($access instanceof AccessResultReasonInterface) {
      $access->setReason("The 'access comments' permission is required and the comment must be published.");
    }
    return $access;

if this is changed, it would actually also be good, I think, if the change record could mention that (and why) the reason shouldn't be translated. That's a bit confusing to me.

Finally: Is this the right way to report mistakes in (or suggestions for) change records? Or are comments monitored usually?