From c22945f4c738f770f4842c6c939690684329a783 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Wed, 9 Oct 2019 12:06:07 +0200 Subject: [PATCH] [2.2.x] 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. Backport of 06e087c3ded703b334a4d7c74a882212774253bc from master --- 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 1c0af171f3..185c6e4494 100644 --- a/docs/internals/contributing/writing-code/unit-tests.txt +++ b/docs/internals/contributing/writing-code/unit-tests.txt @@ -324,6 +324,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`` ----------------------------------------------