Ticket #12191: testpackage.diff

docs/topics/testing.txt

@@ -101 +101 @@
       application-level doctests in the module docstring and model-level
       doctests in the model docstrings.
 
-    * A file called ``tests.py`` in the application directory -- i.e., the
-      directory that holds ``models.py``. This file is a hook for any and all
-      doctests you want to write that aren't necessarily related to models.
+    * A Python package called ``tests`` in the application directory -- i.e.,
+      the directory that holds ``models.py``. This can either be a plain
+      ``tests.py`` file, or a directory with a ``__init__.py`` file where
+      separate classes are imported from the files in that directory. The
+      tests in this package don't have to be related to models. Read Python's
+      official documentation for details on packages_.
 
+.. _packages: http://docs.python.org/tutorial/modules.html#packages
+
 Here is an example model doctest::
 
     # models.py
@@ -163 +168 @@
     * The ``models.py`` file. The test runner looks for any subclass of
       ``unittest.TestCase`` in this module.
 
-    * A file called ``tests.py`` in the application directory -- i.e., the
-      directory that holds ``models.py``. Again, the test runner looks for any
-      subclass of ``unittest.TestCase`` in this module.
+    * A Python package_ called ``tests`` in the application directory --
+      i.e., the directory that holds ``models.py``. Again, the test runner
+      looks for any subclass of ``unittest.TestCase`` in this module.
 
+.. _package: http://docs.python.org/tutorial/modules.html#packages
+
 This example ``unittest.TestCase`` subclass is equivalent to the example given
 in the doctest section above::