From 017f6d9752cc928eb874ee8337698338e57e5978 Mon Sep 17 00:00:00 2001
From: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com>
Date: Thu, 11 Jul 2024 11:06:50 +0200
Subject: [PATCH] IBX-9497: Adjust documentation after bumping the default PHP
 version (#2428)

* Content added (caused by new default PHP version)

* Fixes after rev

* 4.6.8 update section added

---------

Co-authored-by: Julita Falcon Dusza <julitafalcondusza@Users-MacBook-Pro.local>
---
 docs/getting_started/install_ibexa_dxp.md     | 30 ++++++++++---------
 .../from_3.3/update_from_3.3.md               |  8 +++++
 .../from_4.5/update_from_4.5.md               | 10 +++++++
 3 files changed, 34 insertions(+), 14 deletions(-)

diff --git a/docs/getting_started/install_ibexa_dxp.md b/docs/getting_started/install_ibexa_dxp.md
index edd2c80c91..73a77100e5 100644
--- a/docs/getting_started/install_ibexa_dxp.md
+++ b/docs/getting_started/install_ibexa_dxp.md
@@ -113,27 +113,29 @@ After this, when running Composer to get updates, you will be asked for a userna
 To use Composer to instantly create a project in the current folder with all the dependencies,
 run the following command:
 
-=== "[[= product_name_headless =]]"
+!!! note "Using PHP 8.3 (recommended)"
 
-    ``` bash
-    composer create-project ibexa/headless-skeleton .
-    ```
+    === "[[= product_name_headless =]]"
 
-=== "[[= product_name_exp =]]"
+        ``` bash
+        composer create-project ibexa/headless-skeleton .
+        ```
 
-    ``` bash
-    composer create-project ibexa/experience-skeleton .
-    ```
+    === "[[= product_name_exp =]]"
 
-=== "[[= product_name_com =]]"
+        ``` bash
+        composer create-project ibexa/experience-skeleton .
+        ```
 
-    ``` bash
-    composer create-project ibexa/commerce-skeleton .
-    ```
+    === "[[= product_name_com =]]"
+
+        ``` bash
+        composer create-project ibexa/commerce-skeleton .
+        ```
 
-??? note "Using PHP 7.4, 8.0 or 8.3"
+??? note "Using PHP 8.2 or older"
 
-    If you are using PHP 7.4, 8.0 or 8.3, use a different set of commands:
+    If you are using PHP 8.2 or any older version, use a different set of commands:
 
     === "[[= product_name_headless =]]"
 
diff --git a/docs/update_and_migration/from_3.3/update_from_3.3.md b/docs/update_and_migration/from_3.3/update_from_3.3.md
index c6857b19d3..68737b8a89 100644
--- a/docs/update_and_migration/from_3.3/update_from_3.3.md
+++ b/docs/update_and_migration/from_3.3/update_from_3.3.md
@@ -38,6 +38,14 @@ Run:
     composer require ibexa/commerce:[[= latest_tag_3_3 =]] --with-all-dependencies --no-scripts
     ```
 
+To avoid deprecations when updating from an older PHP version to PHP 8.2 or 8.3, run the following commands:
+
+``` bash
+composer config extra.runtime.error_handler
+"\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
+composer dump-autoload
+```
+
 ### Update Flex server
 
 The `flex.ibexa.co` Flex server has been disabled.
diff --git a/docs/update_and_migration/from_4.5/update_from_4.5.md b/docs/update_and_migration/from_4.5/update_from_4.5.md
index d8b4d0f83c..2b0428d46c 100644
--- a/docs/update_and_migration/from_4.5/update_from_4.5.md
+++ b/docs/update_and_migration/from_4.5/update_from_4.5.md
@@ -502,3 +502,13 @@ Run the following scripts:
     ``` bash
     psql <database_name> < vendor/ibexa/installer/upgrade/db/postgresql/ibexa-4.6.3-to-4.6.4.sql
     ```
+
+## v4.6.8
+
+To avoid deprecations when updating from an older PHP version to PHP 8.2 or 8.3, run the following commands:
+
+``` bash
+composer config extra.runtime.error_handler
+"\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
+composer dump-autoload
+```
\ No newline at end of file