Fixed #21991 -- Added warning regarding tests failure if locales not installed.

Thanks reidrac for the report.

1 files changed, 20 insertions, 0 deletions

diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt
index 36f767614a..bcee13f6d3 100644
--- a/docs/internals/contributing/writing-code/unit-tests.txt
+++ b/docs/internals/contributing/writing-code/unit-tests.txt
@@ -49,6 +49,8 @@ You can avoid typing the ``PYTHONPATH`` bit each time by adding your Django
 checkout to your ``PYTHONPATH`` or by installing the source checkout using pip.
 See :ref:`installing-development-version`.
 
+Having problems? See :ref:`troubleshooting-unit-tests` for some common issues.
+
 .. _running-unit-tests-settings:
 
 Using another ``settings`` module
@@ -238,3 +240,21 @@ method as above:
 .. code-block:: bash
 
    $ ./runtests.py --settings=settings django.contrib.auth
+
+.. _troubleshooting-unit-tests:
+
+Troubleshooting
+---------------
+
+Many test failures with ``UnicodeEncodeError``.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the ``locales`` package is not installed, some tests will fail with a
+``UnicodeEncodeError``.
+
+You can resolve this on Debian-based systems, for example, by running:
+
+.. code-block:: bash
+
+    $ apt-get install locales
+    $ dpkg-reconfigure locales