Fixed minor issues only since last RFC update

davedbase · davedbase · commit 94a40f64461c · 2026-03-05T19:13:09.000-05:00
diff --git a/src/routes/configuration/typescript.mdx b/src/routes/configuration/typescript.mdx
@@ -451,7 +451,7 @@ In an environment without TypeScript, using the `ref` attribute in Solid ensures
 ```js
 let divRef;
 console.log(divRef); // Outputs: undefined
-onMount(() => {
+onSettled(() => {
 	console.log(divRef); // Outputs: <div> element
 });
 return <div ref={divRef} />;
@@ -465,17 +465,17 @@ A safe approach in TypeScript is to acknowledge that `divRef` may initially be `
 let divRef: HTMLDivElement | undefined
 // This would be flagged as an error during compilation
 divRef.focus()
-onMount(() => {
+onSettled(() => {
 	if (!divRef) return
 	divRef.focus()
 })
 return <div ref={divRef}>...</div>
 ```
 
-Within the scope of the `onMount` function, which runs after rendering, you can use a non-`null` assertion (indicated by the exclamation mark `!`):
+Within the scope of the `onSettled` function, which runs after rendering, you can use a non-`null` assertion (indicated by the exclamation mark `!`):
 
 ```typescript
-onMount(() => {
+onSettled(() => {
 	divRef!.focus();
 });
 ```
@@ -486,7 +486,7 @@ Another approach is to bypass `null` during the assignment phase and then apply
 let divRef: HTMLDivElement
 // Compilation error as expected
 divRef.focus()
-onMount(() => {
+onSettled(() => {
 	divRef.focus()
 })
 return <div ref={divRef!}>...</div>
@@ -499,9 +499,7 @@ While TypeScript does catch incorrect usage of refs that occur before their
 JSX block definition, it currently does not identify undefined variables
 within certain nested functions in Solid. Therefore, additional care is needed
 when using `ref`s in functions such as
-[`createMemo`](/reference/basic-reactivity/create-memo),
-[`createRenderEffect`](/reference/secondary-primitives/create-render-effect),
-and [`createComputed`](/reference/secondary-primitives/create-computed).
+[`createMemo`](/reference/basic-reactivity/create-memo).
 :::
 
 Finally, a riskier approach involves using the definite assignment assertion right at the point of variable initialization.
@@ -513,7 +511,7 @@ let divRef!: HTMLDivElement;
 // Permitted by TypeScript but will throw an error at runtime:
 // divRef.focus();
 
-onMount(() => {
+onSettled(() => {
 	divRef.focus();
 });
 ```
@@ -737,6 +735,10 @@ declare module "solid-js" {
 
 #### Custom directives
 
+:::caution[Solid 2.0 — `use:` directives are removed]
+In Solid 2.0, `use:` directives are removed. Directives are now expressed as `ref` callbacks/factories. See [Refs](/concepts/refs#directives-via-ref-factories) for the 2.0 pattern. The TypeScript patterns below apply to Solid 1.x and the `@solidjs/legacy` compatibility layer.
+:::
+
 In Solid, custom directives can be applied using the `use:___` attribute, which usually accepts a target element and a JSX attribute value.
 The traditional `Directives` interface types these values directly (i.e. the type of `value` in `<div use:foo={value} />`).
 However, the newer `DirectiveFunctions` interface takes a function type and derives the valid types for elements and values from it.
diff --git a/src/routes/reference/rendering/render-to-stream.mdx b/src/routes/reference/rendering/render-to-stream.mdx
@@ -34,7 +34,7 @@ function renderToStream<T>(
 ```
 
 This method renders to a stream.
-It renders the content synchronously including any Suspense fallback placeholders, and then continues to stream the data and HTML from any async resource as it completes.
+It renders the content synchronously including any Loading fallback placeholders, and then continues to stream the data and HTML from any async resource as it completes.
 
 ```ts
 // node
@@ -46,7 +46,7 @@ renderToStream(App).pipeTo(writable)
 ```
 
 `onCompleteShell` fires when synchronous rendering is complete before writing the first flush to the stream out to the browser.
-`onCompleteAll` is called when all server Suspense boundaries have settled.
+`onCompleteAll` is called when all server Loading boundaries have settled.
 `renderId` is used to namespace renders when having multiple top level roots.
 
 :::note
@@ -61,4 +61,4 @@ renderToStream(App).pipeTo(writable)
 | nonce           | string     | The nonce to use for inline scripts.                             |
 | renderId        | string     | The id to use for this render.                                   |
 | onCompleteShell | () => void | A callback that fires when the shell is complete.                |
-| onCompleteAll   | () => void | A callback that fires when all Suspense boundaries have settled. |
+| onCompleteAll   | () => void | A callback that fires when all Loading boundaries have settled. |
diff --git a/src/routes/reference/rendering/render-to-string-async.mdx b/src/routes/reference/rendering/render-to-string-async.mdx
@@ -29,7 +29,7 @@ function renderToStringAsync<T>(
 
 ```
 
-Same as `renderToString` except that it will wait for all `<Suspense>` boundaries to resolve before returning the results. 
+Same as `renderToString` except that it will wait for all `<Loading>` boundaries to resolve before returning the results. 
 Resource data is automatically serialized into the script tag and will be hydrated on client load.
 
 `renderId` is used to namespace renders when having multiple top level roots.
@@ -42,6 +42,6 @@ const html = await renderToStringAsync(App)
 
 | Name        | Type     | Description                                                                                  |
 | ----------- | -------- | -------------------------------------------------------------------------------------------- |
-| `timeoutMs` | `number` | The number of milliseconds to wait for a `<Suspense>` boundary to resolve before timing out. |
+| `timeoutMs` | `number` | The number of milliseconds to wait for a `<Loading>` boundary to resolve before timing out. |
 | `renderId`  | `string` | The id to use for the render.                                                                |
 | `nonce`     | `string` | The nonce to use for the script tag.                                                         |
