second round feedbacks

Author: zairigimad

src/CalendarLink/config/services.php

@@ -23,11 +23,7 @@
 use Symfony\UX\CalendarLink\Twig\UXCalendarLinkRuntime;
 
 return static function (ContainerConfigurator $container): void {
-    $services = $container->services()
-        ->defaults()
-            ->autowire()
-            ->autoconfigure()
-            ->private();
+    $services = $container->services();
 
     $services->set('ux_calendar_link.provider.google', GoogleCalendarLinkProvider::class)
         ->tag('ux_calendar_link.provider');

src/CalendarLink/doc/index.rst

@@ -1,38 +1,25 @@
 Symfony UX Calendar Link
 ========================
 
-**Symfony UX Calendar Link** generates "Add to calendar" links for Google
-Calendar, Outlook.com, Office 365 and iCalendar (``.ics``) — the format
+**EXPERIMENTAL** This component is currently experimental and is likely
+to change, or even change drastically.
+
+Symfony UX CalendarLink is a Symfony bundle that allows generator of "Add to calendar" links for Google
+Calendar, Outlook.com, Office 365 and iCalendar (``.ics``), the format
 consumed by Apple Calendar, Outlook desktop, Thunderbird and every native
 calendar client.
 
-It addresses the long-standing request in
-`symfony/ux#3308 <https://github.com/symfony/ux/issues/3308>`_ for a
-first-party "Add to calendar" component in the Symfony UX initiative.
-
 Installation
 ------------
 
+Install the bundle using Composer and Symfony Flex:
 .. code-block:: terminal
-
     $ composer require symfony/ux-calendar-link
 
-If you're not using Symfony Flex, enable the bundle manually:
-
-::
-
-    // config/bundles.php
-    return [
-        // ...
-        Symfony\UX\CalendarLink\UXCalendarLinkBundle::class => ['all' => true],
-    ];
-
 Usage
 -----
 
-Build a ``CalendarEvent`` in your controller and pass it to Twig:
-
-::
+Start by creating a CalendarEvent object in your controller. Once populated with your event details, pass it to Twig to render the calendar links::
 
     // src/Controller/EventController.php
     namespace App\Controller;
@@ -52,7 +39,7 @@ Build a ``CalendarEvent`` in your controller and pass it to Twig:
                 title: 'Symfony Live Paris',
                 start: new \DateTimeImmutable('2026-05-14 09:00'),
                 end:   new \DateTimeImmutable('2026-05-15 18:00'),
-                location: 'Disneyland Paris',
+                location: 'Cité Universitaire Paris',
                 description: 'Annual Symfony conference',
             );
 
@@ -96,28 +83,10 @@ provider, because the provider's URL scheme does not support them. For example,
 reminders are honoured only in the ``.ics`` output since Google and Outlook
 deeplink URLs cannot carry VALARM data.
 
-A note on Apple Calendar and EventKit
--------------------------------------
-
-Apple's EventKit (``EKEvent`` / ``EKEventStore``) is a **native iOS/macOS
-API**, not a web URL scheme. There is no proprietary "Add to Apple Calendar"
-deeplink. The correct way to target Apple Calendar from a web page is to
-serve an RFC 5545 ``.ics`` file — Safari on iOS and macOS recognize the
-``text/calendar`` MIME type and offers to add the event directly. The ``ics``
-provider covers Apple Calendar, Outlook desktop, Thunderbird and every other
-native calendar client in a single link.
-
-ICS delivery
-------------
-
-The ``ics`` provider always returns a
-``data:text/calendar;charset=utf-8;base64,...`` URL containing the full
-VCALENDAR payload.
-
 Reminders and recurrence
 ------------------------
 
-::
+Both recurrence rules and reminders can be attached when constructing the event::
 
     use Symfony\UX\CalendarLink\CalendarEvent;
     use Symfony\UX\CalendarLink\CalendarRecurrence;
@@ -135,16 +104,19 @@ Reminders and recurrence
 ``minutely()``, ``daily()``, ``weekly()``, ``monthly()``, ``yearly()`` — each
 accepting the usual ``interval``, ``count`` and ``until`` named arguments:
 
-::
+A few common patterns::
 
-    CalendarRecurrence::daily(interval: 2);                   // every other day
-    CalendarRecurrence::monthly(count: 6);                    // six monthly occurrences
+    // every other day
+    CalendarRecurrence::daily(interval: 2);
+    // six monthly occurrences
+    CalendarRecurrence::monthly(count: 6);
+    // yearly until 2030
     CalendarRecurrence::yearly(until: new \DateTimeImmutable('2030-01-01'));
 
 All-day events
 --------------
 
-::
+Pass allDay: true to create an event with no specific start or end time::
 
     $holiday = new CalendarEvent(
         title: 'Bastille Day',