Add some more PatchElement examples to the SDK ADR (#941)

* Add some more PatchElement examples to the SDK ADR

* Add description of the elements parameter
Split example block and move with other examples

Author: gazpachoking

sdk/README.md

@@ -144,6 +144,47 @@ data: elements </div>
 ```
 </details>
 
+<details>
+<summary>Patch elements based on their id</summary>
+
+```
+event: datastar-patch-elements
+data: elements <div id="id1">New content.</div>
+data: elements <div id="id2">Other new content.</div>
+```
+</details>
+
+<details>
+<summary>Insert a new element based on a selector</summary>
+
+```
+event: datastar-patch-elements
+data: mode append
+data: selector #mycontainer
+data: elements <div>New content</div>
+```
+</details>
+
+<details>
+<summary>Remove elements based on a selector</summary>
+
+```
+event: datastar-patch-elements
+data: mode remove
+data: selector #feed, #otherid
+```
+</details>
+
+<details>
+<summary>Remove elements without a selector</summary>
+
+```
+event: datastar-patch-elements
+data: mode remove
+data: elements <div id="first"></div><div id="second"></div>
+```
+</details>
+
 `PatchElements` sends HTML elements to the browser for DOM manipulation.
 
 > [!TIP]
@@ -162,6 +203,9 @@ data: elements </div>
 
 ### Parameters
 
+- **elements**: One or more complete HTML elements. If a selector has not been specified, each element must contain an
+  id. With ElementPatchMode remove, this parameter may be omitted when a selector is supplied.
+
 #### ElementPatchMode
 
 String enum defining how elements are patched into the DOM.
@@ -183,7 +227,7 @@ String enum defining how elements are patched into the DOM.
 
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `selector` | string | Element's `id` | CSS selector for target element |
+| `selector` | string | Element's `id` | CSS selector for target element. If a selector is not specified, each element must have an id specified. |
 | `mode` | ElementPatchMode | `outer` | How to patch the element |
 | `useViewTransition` | boolean | `false` | Enable view transitions API |