Merge pull request #86 from WICG/noamr-patch-7

noamr · web-flow · commit b2c27c23143d · 2026-02-16T15:55:29.000Z
Add detail about patching behavior after it starts
diff --git a/patching-explainer.md b/patching-explainer.md
@@ -89,6 +89,8 @@ A few details about patching:
 - Templates with a valid `for` attribute are not attached to the DOM, while templates that don't apply are attached to signal an error.
 - If the patching element is not a direct child of `<body>`, the target element has to have a common ancestor with the patching element's parent.
 - The patch template has to be in the same tree (shadow) scope as the target element.
+- When the template's target is discovered, the content between the markers is removed, but the markers are left in the tree until the template is closed.
+- New content is always inserted into the element with the corresponding marker attribute. If the original `<?end>` or `<?marker>` PI is still there, it is inserted before that node. Otherwise, it is appended.
 
 ### Interleaved patching
 
