doc: Document we renamed HdyPaginator into HdyCarousel

doc/hdy-migrating-0-0-to-1.xml

@@ -80,6 +80,16 @@
       </para>
     </refsect3>
 
+    <refsect3>
+      <title>Replace HdyPaginator by HdyCarousel</title>
+      <para>
+        HdyPaginator has been renamed HdyCarousel, so you should replace the
+        former by the later.
+        Similarly, HdyPaginatorIndicatorStyle has been renamed
+        HdyCarouselIndicatorStyle.
+      </para>
+    </refsect3>
+
   </refsect2>
 
 </refentry>