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
 ============