fixes

Author: julitafalcondusza

docs/content_management/collaborative_editing/collaborative_editing.md

@@ -8,8 +8,7 @@ month_change: true
 
 # Collaborative editing
 
-With Collaborative editing feature multiple users can work on the same content created in [[= product_name =]] simultaneously.
-This feature allows multiple users to work together on the same content item in real time, streamlining the content creation and review process.
+With Collaborative editing feature multiple users can work on the same content created in [[= product_name =]] simultaneously, streamlining the content creation and review process.
 
 Users can invite both internal and external collaborators to a session, giving them access for editing or previewing.
 

docs/content_management/collaborative_editing/collaborative_editing_api.md

@@ -9,14 +9,15 @@ month_change: true
 
 [[= product_name =]]'s Collaborative editing API provides two services for managing sessions and invitations, which differ in function:
 
-- [`InvitationServiceInterface`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-InvitationServiceInterface.html) is used to manage collaboration sessions invitations
-- [`SessionServiceInterface`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html) is used to manage collaboration sessions
+- [`InvitationServiceInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-InvitationServiceInterface.html) is used to manage collaboration sessions invitations
+
+- [`SessionServiceInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html) is used to manage collaboration sessions
 
 ## Managing sessions
 
 ### Create session
 
-You can create new collaboration session with [`SessionService::createSession`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_createSession):
+You can create new collaboration session with [`SessionService::createSession`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_createSession):
 
 ``` php
 [[= include_file('code_samples/collaboration/src/Command/ManageSessionsCommand.php', 69, 81) =]]
@@ -40,7 +41,7 @@ You can get an existing collaboration session with [`SessionService::getSession`
 
 ### Find sessions
 
-You can find an existing session with [`SessionService::findSessions`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_findSessions) by:
+You can find an existing session with [`SessionService::findSessions`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_findSessions) by passing a SessionQeury (link to PHP API REF) object::
 
 ``` php
 [[= include_file('code_samples/collaboration/src/Command/ManageSessionsCommand.php', 86, 89) =]]
@@ -82,7 +83,8 @@ You can add participant to the collaboration session with [`SessionService::addP
 
 ### Get and update participant
 
-You can update participant added to the collaboration session with [`SessionService::updateParticipant`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_updateParticipant):
+You can update participant added to the collaboration session with [`SessionService::updateParticipant`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_updateParticipant).
+The example below updates participant's permissions to allow for editing of shared content, not only previewing.
 
 ``` php
 [[= include_file('code_samples/collaboration/src/Command/ManageSessionsCommand.php', 117, 125) =]]
@@ -107,7 +109,7 @@ If no user is provided, current user is used.
 
 ### Check session participant
 
-You can check the participant of the collaboration session with [`SessionService::isSessionParticipant`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_isSessionParticipant):
+You can check whether a user belongs to a collaboration session with [`SessionService::isSessionParticipant`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-Collaboration-SessionServiceInterface.html#method_isSessionParticipant):
 
 ``` php
 [[= include_file('code_samples/collaboration/src/Command/ManageSessionsCommand.php', 135, 140) =]]
@@ -124,7 +126,7 @@ You can get an invitation with [`InvitationService::getInvitation`](https://doc.
 [[= include_file('code_samples/collaboration/src/Command/ManageSessionsCommand.php', 141, 150) =]]
 ```
 
-You can select the parameter that you can read from an invitation:
+You can select the property that you can read from an invitation:
 
 - Invitation ID:
 

docs/content_management/collaborative_editing/install_collaborative_editing.md

@@ -74,7 +74,7 @@ php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/share/src/bundle/Res
 Then, if not using Symfony Flex, add the following code to the `config/bundles.php` file:
 
 ``` php
-    <?php
+<?php
 
 return [
     // A lot of bundles…
@@ -93,29 +93,34 @@ php bin/console ibexa:migrations:import vendor/ibexa/collaboration/src/bundle/Re
 php bin/console ibexa:migrations:migrate --file=2025_08_26_10_14_shareable_user.yaml
 ```
 
-You can now restart you application and start [working with the Collaborative editing feature]([[= user_doc =]]/content_management/collaborative_editing/work_with_collaborative_editing/).
-
-### Security configurations
+### Security configuration
 
 After an installation process is finished, go to `config/packages/security.yaml` and make following changes:
 
 - uncomment following lines with `shared` user provider under the `providers` key:
 
 ```yaml
-providers:
+```suggestion
+security:
+    providers:
+        # ...
         shared:
             id: Ibexa\Collaboration\Security\User\ShareableLinkUserProvider
 ```
 
 - uncomment following lines under the `ibexa_shareable_link` key:
 
 ```yaml
-ibexa_shareable_link:
+security:
+    # ...
+    ibexa_shareable_link:
         request_matcher: Ibexa\Collaboration\Security\RequestMatcher\ShareableLinkRequestMatcher
         pattern: ^/
         provider: shared
         stateless: true
         user_checker: Ibexa\Core\MVC\Symfony\Security\UserChecker
         guard:
             authenticator: Ibexa\Collaboration\Security\Authenticator\ShareableLinkAuthenticator
-```
+```
+
+You can now restart you application and start [working with the Collaborative editing feature]([[= user_doc =]]/content_management/collaborative_editing/work_with_collaborative_editing/).