Document Collaboration events with comprehensive details and examples

[Copilot]

This PR creates comprehensive documentation for Collaboration events by adding a new collaboration_events.md file to the event reference section, following the structure and format of the existing discounts_events.md template.

What's Changed

• New file: docs/api/event_reference/collaboration_events.md
• Documents 21 collaboration events across three functional categories:
  • Session management (9 events): CRUD operations and session interactions
  • Invitation management (6 events): Full lifecycle management of collaboration invitations
  • Participant management (6 events): Adding, updating, and removing participants

Event Coverage

The documentation includes all collaboration events available in the PHP API reference:

Session Events:

• BeforeCreateSessionEvent, CreateSessionEvent
• BeforeUpdateSessionEvent, UpdateSessionEvent
• BeforeDeleteSessionEvent, DeleteSessionEvent
• JoinSessionEvent, LeaveSessionEvent, SessionPublicPreviewEvent

Invitation Events:

• BeforeCreateInvitationEvent, CreateInvitationEvent
• BeforeUpdateInvitationEvent, UpdateInvitationEvent
• BeforeDeleteInvitationEvent, DeleteInvitationEvent

Participant Events:

• BeforeAddParticipantEvent, AddParticipantEvent
• BeforeUpdateParticipantEvent, UpdateParticipantEvent
• BeforeRemoveParticipantEvent, RemoveParticipantEvent

Implementation Details

• Follows the same front matter structure as discounts_events.md
• Uses comprehensive table formatting with Event, "Dispatched by", and "Description" columns
• All API reference links follow the established URL pattern with proper service interface references
• References the existing collaborative editing guide with correct relative path
• Organizes events logically by functional area for better developer experience
• Includes detailed descriptions explaining when each event is dispatched
• Provides practical PHP code examples showing how to create event subscribers
• Features real-world usage examples for notification systems and validation workflows
• Adds contextual explanations for each section describing purpose and use cases

Code Examples

The documentation includes comprehensive PHP examples demonstrating:

• Event subscriber implementation patterns
• Notification system integration for session join/leave events
• Custom validation workflows for invitation management
• Best practices for extending collaboration functionality

This addresses the issue requirement to create collaboration event documentation using the discounts events page as a template, providing developers with a comprehensive reference for extending collaboration functionality through event subscribers.

Fixes #1

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Document Collaboration events</issue_title>
<issue_description>The https://raw.githubusercontent.com/ibexa/documentation-developer/refs/heads/5.0/docs/api/event_reference/discounts_events.md page contains Events for the github.com/ibexa/discounts github.com/ibexa/discounts-codes.

Use it as a template and create a list of events of github.com/ibexa/collaboration/</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #1

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[mnocon]

@copilot make the text longer

[Copilot]

@copilot make the text longer

I've expanded the collaboration events documentation significantly based on your feedback. The updated documentation now includes:

• Detailed descriptions for each event explaining when it's dispatched
• Additional "Description" column in all event tables
• Proper service interface references with links
• Session events organized into CRUD operations and user interactions
• Contextual explanations for each section
• Practical usage examples with PHP code samples showing how to subscribe to events
• Event subscriber examples for common use cases like notifications and validation

The documentation is now much more comprehensive and follows the detailed style of the discounts events template. Commit hash: 8c95073