From 08bc17d18665d6f8d78a5e483f5dfa45dd78eaaa Mon Sep 17 00:00:00 2001
From: cytopia <cytopia@everythingcli.org>
Date: Sun, 18 Mar 2018 18:25:36 +0100
Subject: [PATCH] Warning about use of localhost as TLD

---
 docs/configuration-files/env-file.rst | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/docs/configuration-files/env-file.rst b/docs/configuration-files/env-file.rst
index 417f192d..4114f24d 100644
--- a/docs/configuration-files/env-file.rst
+++ b/docs/configuration-files/env-file.rst
@@ -147,14 +147,24 @@ this project visible to everyone in your corporate LAN.
 +-------------+----------------+---------------------------+
 
 .. warning::
-   Do not use ``dev`` as a domain suffix (I know, it's tempting).
-   It has been registered by
-   `Google <https://icannwiki.org/.dev>`_ and they advertise the
-   `HSTS header <https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security>`_
-   which makes your browser redirect every http request to https.
+    Do not use ``dev`` as a domain suffix (I know, it's tempting).
+    It has been registered by
+    `Google <https://icannwiki.org/.dev>`_ and they advertise the
+    `HSTS header <https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security>`_
+    which makes your browser redirect every http request to https.
 
-   **See also:** `This blog post <https://ma.ttias.be/chrome-force-dev-domains-https-via-preloaded-hsts>`_
+    **See also:** `This blog post <https://ma.ttias.be/chrome-force-dev-domains-https-via-preloaded-hsts>`_
 
+.. warning::
+    Do not use ``localhost`` as a domain suffix.
+    There is an RFC draft to make sure all localhost requests, including their sub domains
+    should be redirected to the systems loopback interface.
+    Docker has already released a commit preventing the use of ``localhost`` on MacOS.
+
+
+    **See also:** `RFC Draft <https://tools.ietf.org/html/draft-west-let-localhost-be-localhost-06>`_
+    and
+    `Docker Release notes <https://docs.docker.com/docker-for-mac/release-notes/#docker-community-edition-17120-ce-mac46-2018-01-09>`_
 
 .. _env_new_uid: