Merge branch 'master' into dam-integration-with-dxp

docs/dam/integration_with_dxp.md

@@ -13,14 +13,13 @@ the following search engines on your server:
 - Elasticsearch
 - Solr
 
-To install and configure search engine of your choice, go to [Elasticsearch documentation](search/search_engines/elastic_search/install_elastic_search.md)
-or to [Solr documentation](search/search_engines/solr_search_engine/install_solr.md)
+To install and configure search engine of your choice, go to [Elasticsearch documentation](install_elastic_search.md)
+or to [Solr documentation](install_solr.md)
 
 
 ## Enable OAuth Servers
 
-Next, enable 0Auth Server authentication. To do it, follow steps to the Client section.
-https://doc.ibexa.co/en/latest/users/oauth_server/.
+Next, enable 0Auth Server authentication. To do it, follow steps to the [Client section](oauth_server.md).
 
 ## Install DAM package
 
@@ -35,17 +34,24 @@ Add the `ibexa_dam_oauth2_client_user` table to the database:
 Add technical users to your [[= product_name =]] instance.
 
 Import migration file:
-`php bin/console ibexa:migrations:import vendor/ibexa/dam-user/src/bundle/Resources/migrations/2024_07_11_09_10_dam_technical_users.yaml`
+
+```bash
+    php bin/console ibexa:migrations:import vendor/ibexa/dam-user/src/bundle/Resources/migrations/2024_07_11_09_10_dam_technical_users.yaml
+```
 
 Run migrations:
-`php bin/console ibexa:migrations:migrate`.
+
+```bash
+php bin/console ibexa:migrations:migrate
+```
 
 Two new user roles and users should be now in the Back Office.
 
 Create OAuth2 client for the DXP user:
 
-`php bin/console ibexa:dam:create-oauth2-client <client-name> <user-identifier>`.
-
+```bash
+php bin/console ibexa:dam:create-oauth2-client <client-name> <user-identifier>
+```
 
 
 <!-- Create database tables for `ibexa_0auth_server`:
@@ -194,6 +200,6 @@ app.config.provider.dam_app:
         - { name: ibexa.admin_ui.config.provider, key: 'damApp' }
 ```
 
-!!! important
+!!! caution
 
-    location 51
+    Location ID must be set to 51, if you provide different location ID, your asset library won't be accessible from DAM.