diff --git a/docs/framework/api-architecture.md b/docs/framework/api-architecture.md
index b04d85ec6cdc790c7954f6e77505b89595b19cbe..88a121ec6790ffe4985c291a71787be9a92378cc 100644
--- a/docs/framework/api-architecture.md
+++ b/docs/framework/api-architecture.md
@@ -9,7 +9,7 @@ v3](/api/index.md) page.
 ## Standards {:#standards}
 
 -   The ONLY supported way to interact with any code in the API folder
-    from outside the api folder is by using the `civicrm_api()` wrapper
+    from outside the api folder is by using the `civicrm_api()` wrapper (or preferably the `civicrm_api3()` wrapper).
 -   Functionality delivered by the API is only supported if it is
     1.  Advertised via the 'getfields function' OR (preferably AND)
     2.  Verified by a test