Ticket #2982: model-api.diff

docs/model-api.txt

@@ -1799 +1799 @@
-        # ...
-        zip_code = models.ForeignKey(ZipCode)
-
+Models inside models/
+=====================
+
+As long as your models get larger you, maybe, will want to split them by taking
+them out of models.py and placing every model on a separate file in models/ .
+First create the directory models/ inside your application, and create a file
+called __init__.py inside it importing your models, i.e.:
+
+   from poll import Poll
+   from choice import Choice
+
+That would import the model Poll from models/poll.py and Choice from models/choice.py.
+Take care that if your models depend on the others you'll need to import them accordingly,
+for example, if Poll depends on a ForeignKey to Choice, on poll.py you'd write:
+
+   from choice import Choice
+
-Using models
-============
-