diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst index 047d458d29b..8366bab3948 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -277,9 +277,11 @@ Test Discovery .. versionadded:: 3.2 -Unittest supports simple test discovery. For a project's tests to be -compatible with test discovery they must all be importable from the top level -directory of the project (in other words, they must all be in Python packages). +Unittest supports simple test discovery. In order to be compatible with test +discovery, all of the test files must be :ref:`modules ` or +:ref:`packages ` importable from the top-level directory of +the project (this means that their filenames must be valid +:ref:`identifiers `). Test discovery is implemented in :meth:`TestLoader.discover`, but can also be used from the command line. The basic command-line usage is::