Improve hook_node_grants() docs around effect of published status of nodes.

Attached patch against Drupal 10.1.x

#43 was not addressed.

Starting March 2023, simple rerolls, rebases, or merges will no longer receive issue credit. Only rerolls that address a merge conflict will be credited, and the merge conflict that was resolved must be documented in the text of an issue comment.

Example
error: patch failed: core/modules/system/tests/modules/twig_theme_test/twig_theme_test.module:77
error: core/modules/system/tests/modules/twig_theme_test/twig_theme_test.module: patch does not apply

To receive credit for contributing to this issue, assist with other outstanding tasks or unaddressed feedback.
See the issue credit guidelines → for more information.

Rerolled #32

Cleanup

Posted in slack and @chx was kind enough to give a look and apparently this needs some work.