Stop calling Foo.objects.create() when it doesn't break (Closes #23).

This will be properly fixed in v2.0.0; the current heuristic is:
- If the user defined a custom _create method, use it
- If he didn't, but the associated class has a objects attribute, use TheClass.objects.create(*args, **kwargs)
- Otherwise, simply call TheClass(*args, **kwargs).

Signed-off-by: Raphaël Barrois <raphael.barrois@polytechnique.org>

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/reference.rst b/docs/reference.rst
index 6d01e5d..03023fc 100644
--- a/docs/reference.rst
+++ b/docs/reference.rst
@@ -235,6 +235,15 @@ factory_boy supports two main strategies for generating instances, plus stubs.
 
     .. OHAI_VIM*
 
+    .. warning:: For backward compatibility reasons, the default behaviour of
+                 factory_boy is to call ``MyClass.objects.create(*args, **kwargs)``
+                 when using the ``create`` strategy.
+
+                 That policy will be used if the
+                 :attr:`associated class <Factory.FACTORY_FOR>` has an ``objects``
+                 attribute *and* the :meth:`~Factory._create` classmethod of the
+                 :class:`Factory` wasn't overridden.
+
 
 .. function:: use_strategy(strategy)