Upgrade notes from 0.16.* to 2.0 are a bit too light on details

[kgilden]

As a consumer of this package, it's difficult to upgrade from 0.16.* to 2.0. The upgrade docs gives a nice general impression of how the package should now be used, but it's lacking specifics.

It would be extremely helpful, if there was a before vs after of all public methods showing how each method was used in 0.16.* and how the same thing could be achieved with 2.0.

Below is an example for Calendar::setPublishedTTL, but to be honest I'm not even sure if my example of 2.0 is even correct.

Calendar

• Calendar::setPublishedTTL() has been removed.

  // Before
  use Eluceo\iCal\Component\Calendar;
  
  $calendar = new Calendar();
  $calendar->setPublishedTTL('PT1H');
  
  // After
  use Eluceo\iCal\Presentation\Factory\CalendarFactory;
  use Eluceo\iCal\Domain\Entity\Calendar;
  use Eluceo\iCal\Presentation\Component\Property;
  use Eluceo\iCal\Presentation\Component\Property\Value\DurationValue;
  
  $component = (new CalendarFactory())
      ->createCalendar(new Calendar())
      ->withProperty(new Property('X-PUBLISHED-TTL', DurationValue(new \DateInterval('P1H'))));

• Calendar::setCalId() has been removed.

  ...