Issue #2473093 by acbramley, xjm: Node access default grant behavior is not clear

(cherry picked from commit e255c27d)

core/modules/node/src/NodeAccessControlHandlerInterface.php

@@ -30,6 +30,8 @@ public function acquireGrants(NodeInterface $node);
 
   /**
    * Creates the default node access grant entry on the grant storage.
+   *
+   * @see \Drupal\node\NodeGrantDatabaseStorageInterface::writeDefault()
    */
   public function writeDefaultGrant();
 

core/modules/node/src/NodeGrantDatabaseStorageInterface.php

@@ -83,6 +83,12 @@ public function delete();
 
   /**
    * Creates the default node access grant entry.
+   *
+   * The default node access grant is a special grant added to the node_access
+   * table when no modules implement hook_node_grants. It grants view access
+   * to any published node.
+   *
+   * @see self::access()
    */
   public function writeDefault();