diff --git a/docs/core/architecture.md b/docs/core/architecture.md
index c4504672f15b192a713bff005485c4a5b15899bf..8f8bf96f85acd8d1ba8341d1bbd50f28c6231dba 100644
--- a/docs/core/architecture.md
+++ b/docs/core/architecture.md
@@ -107,11 +107,8 @@ activity is created, or create activities and populating custom fields when a
 pledge is created.
 
 !!! note
-    BAOs typically have both `add()` and `create()` methods. The `add()` method
-    just creates the database record with the DAO `save()` method whereas 'create()' calls
-    subsidiary functions such as creating activities & populating custom fields.
-    The APIs call 'Create' which then calls 'Add' as well as other associated
-    functions.
+    Historically some BAOs had both `add()` and `create()` methods. Current practice 
+    is to favour a single `create()` method.
 
 ### Form
 In general each form page in CiviCRM maps to a file in one of