[libadwaita/wip/exalm/spring-animation-swipes: 5/5] doc: Update migration guide

[Alexander Mikhaylenko <alexm src gnome org>]

commit 8839f3fdfd449797f9fb26c9aff31a47eeb3dbf2
Author: Alexander Mikhaylenko <alexm gnome org>
Date:   Mon Dec 6 17:43:17 2021 +0500

    doc: Update migration guide

 doc/migrating-between-development-versions.md | 30 ++++++++++++++++++++++-----
 doc/migrating-libhandy-1-4-to-libadwaita.md   | 30 ++++++++++++++++++++++-----
 2 files changed, 50 insertions(+), 10 deletions(-)
---
diff --git a/doc/migrating-between-development-versions.md b/doc/migrating-between-development-versions.md
index 4f932634..4a3fab70 100644
--- a/doc/migrating-between-development-versions.md
+++ b/doc/migrating-between-development-versions.md
@@ -292,6 +292,31 @@ The `can-swipe-back` and `can-swipe-forward` properties have been renamed to
 [property@AdwLeaflet:can-navigate-forward], along with their accessors. The new
 properties also handle keyboard and mouse shortcuts in addition to swipes.
 
+`AdwLeaflet` now uses spring animations instead of timed animations for child
+transitions. As such, the `child-transition-duration` property has been replaced
+with [property@Adw.Leaflet:child-transition-params], allowing to customize the
+animation. Unlike the duration, spring parameters are also used for animation
+triggered by swipe gestures.
+
+### Adapt to [class Adw Flap] API Changes
+
+`AdwFlap` now uses spring animations instead of timed animations for reveal
+animations. As such, the `reveal-duration` property has been replaced with
+[property Adw Flap:reveal-params], allowing to customize the animation. Unlike
+the duration, spring parameters are also used for transitions triggered by swipe
+gestures.
+
+### Adapt to [class@Adw.Carousel] API changes
+
+`AdwCarousel` now uses spring animations instead of timed animations for
+scrolling. As such, the `animation-duration` property has been replaced with
+[property@Adw.Carousel:scroll-params], allowing to customize the animation.
+Unlike the duration, spring parameters are also used for animation triggered
+by swipe gestures.
+
+The `adw_carousel_scroll_to_full()` method has been removed. Instead,
+[method@Adw.Carousel.scroll_to] has got an additional parameter `animate`.
+
 ### Adapt to [class@Adw.PreferencesWindow] API changes
 
 The `can-swipe-back` property have been renamed to
@@ -299,11 +324,6 @@ The `can-swipe-back` property have been renamed to
 The new properties also handle keyboard and mouse shortcuts in addition to
 swipes.
 
-### Adapt to [class@Adw.Carousel] API changes
-
-The type of the `duration` parameter in [method@Adw.Carousel.scroll_to_full] has
-changed from `gint64` to `guint`.
-
 ### Adapt to [class@Adw.ViewStack] API changes
 
 [class@Adw.ViewStack] has stopped supporting transitions. As such, the
diff --git a/doc/migrating-libhandy-1-4-to-libadwaita.md b/doc/migrating-libhandy-1-4-to-libadwaita.md
index 68397d98..992a6fcb 100644
--- a/doc/migrating-libhandy-1-4-to-libadwaita.md
+++ b/doc/migrating-libhandy-1-4-to-libadwaita.md
@@ -277,6 +277,31 @@ to make them homogeneous if needed.
 The `interpolate-size` property has been removed with no replacement, it's
 always enabled when [property@Adw.Leaflet:homogeneous] is set to `FALSE`.
 
+`AdwLeaflet` now uses spring animations instead of timed animations for child
+transitions. As such, the `child-transition-duration` property has been replaced
+with [property@Adw.Leaflet:child-transition-params], allowing to customize the
+animation. Unlike the duration, spring parameters are also used for animation
+triggered by swipe gestures.
+
+### Adapt to [class Adw Flap] API Changes
+
+`AdwFlap` now uses spring animations instead of timed animations for reveal
+animations. As such, the `reveal-duration` property has been replaced with
+[property Adw Flap:reveal-params], allowing to customize the animation. Unlike
+the duration, spring parameters are also used for transitions triggered by swipe
+gestures.
+
+### Adapt to [class@Adw.Carousel] API changes
+
+`AdwCarousel` now uses spring animations instead of timed animations for
+scrolling. As such, the `animation-duration` property has been replaced with
+[property@Adw.Carousel:scroll-params], allowing to customize the animation.
+Unlike the duration, spring parameters are also used for animation triggered
+by swipe gestures.
+
+The `adw_carousel_scroll_to_full()` method has been removed. Instead,
+[method@Adw.Carousel.scroll_to] has got an additional parameter `animate`.
+
 ### Adapt to view switcher API Changes
 
 [class@Adw.ViewSwitcher], [class@Adw.ViewSwitcherBar] and
@@ -359,11 +384,6 @@ The `can-swipe-back` property have been renamed to
 The new properties also handle keyboard and mouse shortcuts in addition to
 swipes.
 
-### Adapt to [class@Adw.Carousel] API changes
-
-The type of the `duration` parameter in [method@Adw.Carousel.scroll_to_full] has
-changed from `gint64` to `guint`.
-
 ### Adapt to Miscellaneous Changes
 
 The `hdy_ease_out_cubic()` function has been removed. Instead,