diff --git a/docs/src/developing/backwards-compatibility.md b/docs/src/developing/backwards-compatibility.md
index ce60557b1..4a3c60b8e 100644
--- a/docs/src/developing/backwards-compatibility.md
+++ b/docs/src/developing/backwards-compatibility.md
@@ -149,3 +149,9 @@ software releases.
 
 If a new attack vector is discovered in existing code, the above processes may be
 circumvented in order to rapidly deploy a fix, depending on the severity of the issue.
+
+#### CLI Tooling Output
+
+CLI tooling json output (`output --json`) compatibility will be preserved; however, output directed
+for a human reader is subject to change. This includes output as well as potential help, warning, or
+error messages.