jsonapi.api.php                           | 15 ++++++++++-----
 tests/src/Functional/BlockContentTest.php |  4 ++++
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/jsonapi.api.php b/jsonapi.api.php
index 88d9f98..fb2ed41 100644
--- a/jsonapi.api.php
+++ b/jsonapi.api.php
@@ -99,14 +99,19 @@
  * The JSON API module comes with extensive unit and kernel tests. But most
  * importantly for end users, it also has comprehensive integration tests. These
  * integration tests are designed to:
+ *
  * - ensure a great DX (Developer Experience)
  * - detect regressions and normalization changes before shipping a release
  * - guarantee 100% of Drupal core's entity types work as expected
- * - by test the same common cases and edge cases for all JSON API resource
- *   types (which correspond to Drupal entity types + bundles)
- * - thus also allowing developers of custom entity types to get the same strong
- *   assurances, by subclassing
- *   @code \Drupal\Tests\jsonapi\Functional\ResourceTestBase @endcode
+ *
+ * The integration tests test the same common cases and edge cases using
+ * @code \Drupal\Tests\jsonapi\Functional\ResourceTestBase @endcode, which is a
+ * base class subclassed for every entity type that Drupal core ships with. It
+ * is ensured that 100% of Drupal core's entity types are tested thanks to
+ * @code \Drupal\Tests\jsonapi\Functional\TestCoverageTest @endcode.
+ *
+ * Custom entity type developers can get the same assurances by subclassing it
+ * for their entity types.
  *
  *
  * @section bc Backwards Compatibility
diff --git a/tests/src/Functional/BlockContentTest.php b/tests/src/Functional/BlockContentTest.php
index bd72538..284d65c 100644
--- a/tests/src/Functional/BlockContentTest.php
+++ b/tests/src/Functional/BlockContentTest.php
@@ -153,6 +153,10 @@ class BlockContentTest extends ResourceTestBase {
           ],
           'revision_user' => [
             'data' => NULL,
+            'links' => [
+              'related' => $self_url . '/revision_user',
+              'self' => $self_url . '/relationships/revision_user',
+            ]
           ],
         ],
       ],