minor #12303 Improved the docs about automatic proxy in Symfony server (javiereguiluz)

javiereguiluz · javiereguiluz · commit a7ce0649407d · 2019-09-12T10:52:29.000+02:00
This PR was merged into the 3.4 branch. Discussion ---------- Improved the docs about automatic proxy in Symfony server Finding these "proxy settings" is not a trivial thing, so let's add some help. By the way, I tried hard to find the official Windows/Microsoft help about "proxy settings" but I couldn't, so that's why I had to use a different URL. Commits ------- 89e7ea5 Improved the docs about automatic proxy in Symfony server
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
@@ -184,11 +184,12 @@ server. First, start the proxy:
 
     $ symfony proxy:start
 
-If this is the first time you run the proxy, you must follow these additional steps:
+If this is the first time you run the proxy, you must configure it as follows:
 
-* Open the **network configuration** of your operating system;
-* Find the **proxy settings** and select the **"Automatic Proxy Configuration"**;
-* Set the following URL as its value: ``http://127.0.0.1:7080/proxy.pac``
+* Open the **proxy settings** of your operating system (`proxy settings in Windows`_,
+  `proxy settings in macOS`_, `proxy settings in Ubuntu`_);
+* Set the following URL as the value of the **Automatic Proxy Configuration**:
+  ``http://127.0.0.1:7080/proxy.pac``
 
 Defining the Local Domain
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -370,3 +371,6 @@ that Composer will also set the stability to ``dev`` for all root dependencies):
 .. _`Docker`: https://en.wikipedia.org/wiki/Docker_(software)
 .. _`SymfonyCloud`: https://symfony.com/cloud/
 .. _`Read SymfonyCloud technical docs`: https://symfony.com/doc/master/cloud/intro.html
+.. _`proxy settings in Windows`: https://www.dummies.com/computers/operating-systems/windows-10/how-to-set-up-a-proxy-in-windows-10/
+.. _`proxy settings in macOS`: https://support.apple.com/guide/mac-help/enter-proxy-server-settings-on-mac-mchlp2591/mac
+.. _`proxy settings in Ubuntu`: https://help.ubuntu.com/stable/ubuntu-help/net-proxy.html.en
