jsonapi.api.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/jsonapi.api.php b/jsonapi.api.php
index e8123e1..433a2ef 100644
--- a/jsonapi.api.php
+++ b/jsonapi.api.php
@@ -173,7 +173,9 @@ use Drupal\Core\Access\AccessResult;
  * HTTP API: URLs and JSON response structures are considered part of this
  * module's public API. However, inconsistencies with the JSON:API specification
  * will be considered bugs. Fixes which bring the module into compliance with
- * the specification are *not* guaranteed to be backwards-compatible.
+ * the specification are *not* guaranteed to be backwards-compatible. When
+ * compliance bugs are found, clients are expected to be made compatible with
+ * both the pre-fix and post-fix representations.
  *
  * What this means for developing consumers of the HTTP API is that *clients
  * should be implemented from the specification first and foremost.* This should