docs: Update migration and remove MIGRATION.md

Author: linkdotnet

MIGRATION.md

@@ -11,7 +11,6 @@
   </Folder>
   <Folder Name="/.text/">
     <File Path="CHANGELOG.md" />
-    <File Path="MIGRATION.md" />
     <File Path="README.md" />
   </Folder>
   <Folder Name="/.workflows/">

bunit.slnx

@@ -78,4 +78,38 @@ cut.Find("button").Click(detail: 2, ctrlKey: true);
 
 The last one was a method with all parameters of `MouseEventArgs` as optional parameters. This method has been removed in favor of using the `MouseEventArgs` directly.
 
-Also `ClickAsync` - to align with its synchronous counterpart - doesn't take `MouseEventArgs` as mandatory parameter anymore. If not set, a default instance will be created.
+Also `ClickAsync` - to align with its synchronous counterpart - doesn't take `MouseEventArgs` as mandatory parameter anymore. If not set, a default instance will be created.
+
+## `DisposeComponents` is now async and called `DisposeComponentsAsync`
+
+The `DisposeComponents` method has been renamed to `DisposeComponentsAsync` and is now asynchronous. To migrate, simply rename the method and add `await`:
+
+```diff
+- DisposeComponents();
++ await DisposeComponentsAsync();
+```
+
+## The `ComponentParameterFactory` and `ComponentParameter` has been removed
+The `ComponentParameterFactory` class has been removed (and therefore the usage of `ComponentParameter`).
+Instead, use the `Render` method (and its overloads) to pass parameters to components.
+
+## `IRefreshableElementCollection` was removed
+The `IRefreshableElementCollection` interface has been removed. With that, the overload in `FindAll` doesn't accept a `bool refresh` parameter anymore. Instead, simply call `FindAll` again to get a refreshed collection.
+
+```csharp
+var items = cut.FindAll("li", refresh: true);
+items.Count.ShouldBe(3);
+cut.Find("button").Click(); // This changes the list items
+
+items.Count.ShouldBe(4);
+```
+
+Should be changed to:
+
+```csharp
+var items = cut.FindAll("li");
+items.Count.ShouldBe(3);
+cut.Find("button").Click(); // This changes the list items
+items = cut.FindAll("li"); // Call FindAll again to refresh
+items.Count.ShouldBe(4);
+```