diff --git a/core/modules/system/entity.api.php b/core/modules/system/entity.api.php
index 9d9b33e..1f7f665 100644
--- a/core/modules/system/entity.api.php
+++ b/core/modules/system/entity.api.php
@@ -522,7 +522,12 @@
  *    The code of the language $entity is accessed in.
  *
  * @return \Drupal\Core\Access\AccessResultInterface
- *    The access result.
+ *    The access result. The final result is calculated using from chaining
+ *    every result with \Drupal\Core\Access\AccessResultInterface::orIf().
+ *    Be mindful of the difference to routing access checks which are chained
+ *    through andIf: for entity access checks an isNeutral() result might
+ *    become allowed at the end, for routing an isNeutral() always ends up
+ *    denying access.
  *
  * @see \Drupal\Core\Entity\EntityAccessControlHandler
  * @see hook_entity_create_access()
@@ -548,7 +553,7 @@ function hook_entity_access(\Drupal\Core\Entity\EntityInterface $entity, $operat
  *    The code of the language $entity is accessed in.
  *
  * @return \Drupal\Core\Access\AccessResultInterface
- *    The access result.
+ *    The access result. hook_entity_access() has detailed documentation.ag ser
  *
  * @see \Drupal\Core\Entity\EntityAccessControlHandler
  * @see hook_ENTITY_TYPE_create_access()