diff --git a/manual/docs/Coding standards - Naming Conventions - Variables.php b/manual/docs/Coding standards - Naming Conventions - Variables.php
index 32b107b20..bbf3094b2 100644
--- a/manual/docs/Coding standards - Naming Conventions - Variables.php
+++ b/manual/docs/Coding standards - Naming Conventions - Variables.php
@@ -11,3 +11,18 @@ All variables must satisfy the following conditions:
- Verbosity is encouraged. Variables should always be as verbose as practical. Terse variable names such as "$i" and "$n" are discouraged for anything other than the smallest loop contexts. If a loop contains more than 20 lines of code, the variables for the indices need to have more descriptive names.
+
+
+- Within the framework certain generic object variables should always use the following names:
+
+
+ - Doctrine_Connection -> $conn
+
- Doctrine_Collection -> $coll
+
- Doctrine_Manager -> $manager
+
- Doctrine_Query -> $query
+
- Doctrine_Db -> $db
+
+
+ There are cases when more descriptive names are more appropriate (for example when multiple objects of the same class are used in same context),
+ in that case it is allowed to use different names than the ones mentioned.
+