From 1a039e76c74c5dbea0943782bfba9924e8051a4e Mon Sep 17 00:00:00 2001
From: Alix Martineau <alix.martineau@ripplemotion.fr>
Date: Sat, 5 Nov 2016 16:25:16 +0100
Subject: [PATCH] [1.10.x] Fixed #27439 -- Documented macOS locale
 configuration for Django tests.

Backport of 0a8c685447eea8fc7aa34ea444a3156ee489379f from master
---
 docs/internals/contributing/writing-code/unit-tests.txt | 9 +++++++++
 docs/spelling_wordlist                                  | 1 +
 2 files changed, 10 insertions(+)

diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt
index 1c382c79cd..f686ae6fe6 100644
--- a/docs/internals/contributing/writing-code/unit-tests.txt
+++ b/docs/internals/contributing/writing-code/unit-tests.txt
@@ -259,6 +259,15 @@ You can resolve this on Debian-based systems, for example, by running::
     $ apt-get install locales
     $ dpkg-reconfigure locales
 
+You can resolve this for macOS systems by configuring your shell's locale::
+
+    $ export LANG="en_US.UTF-8"
+    $ export LC_ALL="en_US.UTF-8"
+
+Run the ``locale`` command to confirm the change. Optionally, add those export
+commands to your shell's startup file (e.g. ``~/.bashrc`` for Bash) to avoid
+having to retype them.
+
 Tests that only fail in combination
 -----------------------------------
 
diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist
index 3eab2ce799..a8b0184d70 100644
--- a/docs/spelling_wordlist
+++ b/docs/spelling_wordlist
@@ -451,6 +451,7 @@ lowercasing
 lt
 lte
 Luhn
+macOS
 Magee
 makemessages
 makemigrations