doc: Document recent HdyCarousel changes
181f2f58 changed the API of
HdyCarousel, given the "Adapt to HdyPaginator API changes" section in the migration doc doesn't present
HdyCarousel as a different widget from
HdyPaginator but as its evolution, maybe we should document the dropped indicators, the dropped properties, and the replacement.