Issue #789484 by Lars Toomre, sven.lauer, pillarsdotnet, michaellenahan,...

Issue #789484 by Lars Toomre, sven.lauer, pillarsdotnet, michaellenahan, Mac_Weber: Fixed confusing documentation for  argument in hook_access()/hook_node_access().

core/modules/node/node.api.php

@@ -565,7 +565,7 @@ function hook_node_load($nodes, $types) {
  * Blindly returning FALSE will break other node access modules.
  *
  * @param object|string $node
- *   Either a node object or a (machine-readable) content type on which to
+ *   Either a node object or the machine name of the content type on which to
  *   perform the access check.
  * @param string $op
  *   The operation to be performed. Possible values:
@@ -577,9 +577,9 @@ function hook_node_load($nodes, $types) {
  *   The user object to perform the access check operation on.
  *
  * @return integer
- *   NODE_ACCESS_ALLOW if the operation is to be allowed;
- *   NODE_ACCESS_DENY if the operation is to be denied;
- *   NODE_ACCESS_IGNORE to not affect this operation at all.
+ *   - NODE_ACCESS_ALLOW: if the operation is to be allowed.
+ *   - NODE_ACCESS_DENY: if the operation is to be denied.
+ *   - NODE_ACCESS_IGNORE: to not affect this operation at all.
  *
  * @ingroup node_access
  */