IBX-2336 documented: "Move VCL macro call" (#1565)

* IBX-2336 documented: "Move VCL macro call"

* Review comments implemented

Author: dabrt

docs/snippets/update/vcl_configuration_for_fastly.md

@@ -0,0 +1,13 @@
+If you use Fastly, deploy the most up-to-date VCL configuration.
+
+Locate the `vendor/ezsystems/ezplatform-http-cache-fastly/fastly/ez_main.vcl` file, make sure that it has been updated with the following changes, and upload it to your Fastly:
+
+- Add the following lines:
+
+``` vcl
+if (req.restarts == 0 && resp.status == 301 && req.http.x-fos-original-url) {
+    set resp.http.location = regsub(resp.http.location, "/_fos_user_context_hash", req.http.x-fos-original-url);
+}
+```
+
+- Move the `#FASTLY recv` macro call to a new location, right after the `Preserve X-Forwarded-For in all requests` section.

docs/updating/from_1.x_2.x/update_db_to_2.5.md

@@ -880,15 +880,7 @@ You do this manually by following this procedure:
 
 ###### VCL configuration for Fastly
 
-If you use Fastly, update your VCL configuration.
-
-Locate the `vendor/ezsystems/ezplatform-http-cache-fastly/fastly/ez_main.vcl` file and add the following lines to it:
-
-``` vcl
-if (req.restarts == 0 && resp.status == 301 && req.http.x-fos-original-url) {
-    set resp.http.location = regsub(resp.http.location, "/_fos_user_context_hash", req.http.x-fos-original-url);
-}
-```
+[[% include 'snippets/update/vcl_configuration_for_fastly.md' %]]
 
 ##### Optimize workflow queries
 

docs/updating/from_2.5/to_3.3.latest.md

@@ -43,15 +43,7 @@ You do this manually by following this procedure:
 
 #### VCL configuration for Fastly
 
-If you use Fastly, update your VCL configuration.
-
-Locate the `vendor/ezsystems/ezplatform-http-cache-fastly/fastly/ez_main.vcl` file and add the following lines to it:
-
-``` vcl
-if (req.restarts == 0 && resp.status == 301 && req.http.x-fos-original-url) {
-    set resp.http.location = regsub(resp.http.location, "/_fos_user_context_hash", req.http.x-fos-original-url);
-}
-```
+[[% include 'snippets/update/vcl_configuration_for_fastly.md' %]]
 
 #### Optimize workflow queries
 

docs/updating/from_3.3/update_from_3.3.md

@@ -106,15 +106,7 @@ You do this manually by following this procedure:
 
 #### VCL configuration for Fastly
 
-If you use Fastly, update your VCL configuration.
-
-Locate the `vendor/ezsystems/ezplatform-http-cache-fastly/fastly/ez_main.vcl` file and add the following lines to it:
-
-``` vcl
-if (req.restarts == 0 && resp.status == 301 && req.http.x-fos-original-url) {
-    set resp.http.location = regsub(resp.http.location, "/_fos_user_context_hash", req.http.x-fos-original-url);
-}
-```
+[[% include 'snippets/update/vcl_configuration_for_fastly.md' %]]
 
 #### Optimize workflow queries