From a6c88b92264ba4a7976033fc0de73aaaf297c678 Mon Sep 17 00:00:00 2001
From: slhx agent <slhx@users.noreply.github.com>
Date: Tue, 2 Jun 2026 03:12:49 +0200
Subject: [PATCH] docs(api): hide raw render extension shims

Keep compatibility helpers available while steering author docs toward generated lower-aware put/append/replace commands.

req: dx/006
---
 slhx/src/lib.rs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/slhx/src/lib.rs b/slhx/src/lib.rs
index c5ba711..7d32251 100644
--- a/slhx/src/lib.rs
+++ b/slhx/src/lib.rs
@@ -17,6 +17,11 @@ pub fn render_html(view: &impl hemplate::Hemplate) -> SafeHtml {
     render(view)
 }
 
+/// Compatibility shim for raw slot rendering.
+///
+/// Prefer generated view-module commands such as `ui::put(slot, &view)` so
+/// generated resource lowering stays attached to the view boundary. req: dx/006
+#[doc(hidden)]
 pub trait RenderSlotExt {
     fn render(self, view: &impl hemplate::Hemplate) -> Effect;
 
@@ -34,6 +39,11 @@ impl<T> RenderSlotExt for Slot<T> {
     }
 }
 
+/// Compatibility shim for raw keyed slot rendering.
+///
+/// Prefer generated view-module commands such as `ui::append(slot, key, &view)`
+/// so generated resource lowering stays attached to the view boundary. req: dx/006
+#[doc(hidden)]
 pub trait RenderKeyedSlotExt<K> {
     fn append(self, key: K, view: &impl hemplate::Hemplate) -> Effect;
     fn prepend(self, key: K, view: &impl hemplate::Hemplate) -> Effect;