From 06e087c3ded703b334a4d7c74a882212774253bc Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Wed, 9 Oct 2019 12:06:07 +0200 Subject: [PATCH] Added note to check Python version in unit tests troubleshooting section. At DjangoCon US 2019 sprints, a number of contributors hit problems with an outdated Python. --- docs/internals/contributing/writing-code/unit-tests.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt index 29a9fbc4d0..e9db0fe44a 100644 --- a/docs/internals/contributing/writing-code/unit-tests.txt +++ b/docs/internals/contributing/writing-code/unit-tests.txt @@ -373,6 +373,13 @@ in ``tests/auth_tests``. Troubleshooting =============== +Test suite hangs or shows failures on ``master`` branch +------------------------------------------------------- + +Ensure you have the latest point release of a :ref:`supported Python version +`, since there are often bugs in earlier versions +that may cause the test suite to fail or hang. + Many test failures with ``UnicodeEncodeError`` ----------------------------------------------