2 files changed, 8 insertions, 0 deletions
diff --git a/core/modules/node/src/NodeAccessControlHandlerInterface.php b/core/modules/node/src/NodeAccessControlHandlerInterface.php
index 588391394eec..0d67cfb7bd69 100644
--- a/core/modules/node/src/NodeAccessControlHandlerInterface.php
+++ b/core/modules/node/src/NodeAccessControlHandlerInterface.php
@@ -30,6 +30,8 @@ interface NodeAccessControlHandlerInterface {
 
   /**
    * Creates the default node access grant entry on the grant storage.
+   *
+   * @see \Drupal\node\NodeGrantDatabaseStorageInterface::writeDefault()
    */
   public function writeDefaultGrant();
 
diff --git a/core/modules/node/src/NodeGrantDatabaseStorageInterface.php b/core/modules/node/src/NodeGrantDatabaseStorageInterface.php
index cce744765630..5e81e1d04d0b 100644
--- a/core/modules/node/src/NodeGrantDatabaseStorageInterface.php
+++ b/core/modules/node/src/NodeGrantDatabaseStorageInterface.php
@@ -83,6 +83,12 @@ interface NodeGrantDatabaseStorageInterface {
 
   /**
    * 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();