docs: clarify TailHTML usage and fix documentation typos

linkdata · linkdata · commit 79fdec982c5b · 2026-05-13T13:31:38.000+02:00
diff --git a/.agents/skills/jaws/SKILL.md b/.agents/skills/jaws/SKILL.md
@@ -119,7 +119,7 @@ For clickable content rendering:
 ## Rendering and update rules
 
 - Keep HTML structure in templates; avoid manual HTML string assembly in Go.
-- `ui.Template.JawsUpdate` re-renders the template data into the generated wrapper; custom `Dot.JawsUpdate` methods are not called by Template.
+- `ui.Template.JawsUpdate` re-renders the template data into the generated wrapper.
 - HTML getter paths must not mutate domain state, but they may call element update methods (`SetClass`, `RemoveClass`, `SetAttr`, `RemoveAttr`, etc.) on the passed-in `*Element` to co-ordinate wrapper class/attribute changes with the inner-HTML refresh. No custom `JawsUpdate` is needed for that case — the queued wrapper updates flush alongside the `SetInner` from `HTMLInner.JawsUpdate`.
 - Use a custom `JawsUpdate` only when the widget's update logic diverges from "render the getter again" — e.g. to compare against a stored last-value and skip the update (as the input widgets do).
 - `Element.SetAttr/RemoveAttr/SetClass/RemoveClass/SetInner/SetValue/Append/Order/Remove/Replace` are update-time operations; call them only from render/update processing.
diff --git a/README.md b/README.md
@@ -43,7 +43,7 @@ For widget authoring guidance see `lib/ui/README.md`.
 
 ### AI skill
 
-This repository includes a AI skill under `.agents/skills/jaws/`.
+This repository includes an AI skill under `.agents/skills/jaws/`.
 To install it in your local AI skills tree, copy both `SKILL.md` and
 `agents/openai.yaml` into `~/.agents/skills/jaws/`.
 
@@ -81,7 +81,7 @@ import (
 const indexhtml = `
 <html>
 <head>{{$.HeadHTML}}</head>
-<body>{{$.Range .Dot}}</body>
+<body>{{$.Range .Dot}}{{$.TailHTML}}</body>
 </html>
 `
 
@@ -173,9 +173,9 @@ client/server protocol code:
 ### HTTP request flow and associating the WebSocket
 
 When a new HTTP request is received, create a JaWS Request using the
-JaWS object's `NewRequest()` method, and then use the Request's
-`HeadHTML()` method to get the HTML code needed in the `<head>` section
-of the HTML page.
+JaWS object's `NewRequest()` method, then use the Request's `HeadHTML()`
+method in the `<head>` section and `TailHTML()` before the closing
+`</body>` tag.
 
 When the client has finished loading the document and parsed the
 scripts, the JaWS JavaScript will request a WebSocket connection on
@@ -372,8 +372,8 @@ create the Request object. This value is written to the HTML output so it
 can be read by the JavaScript, and used to construct the WebSocket callback
 URL.
 
-Once the WebSocket call comes in, the value is consumed by that request,
-and is no longer valid until, theoretically, another Request gets the same
+Once the WebSocket call comes in, the value is consumed by that request.
+The same value can only be used again if a later Request receives the same
 random value. And that's fine, since JaWS guarantees that no two Requests
 waiting for WebSocket calls can have the same value at the same time.
 
diff --git a/examples/example_test.go b/examples/example_test.go
@@ -16,8 +16,7 @@ const indexhtml = `
   <head>{{$.HeadHTML}}</head>
   <body>{{with .Dot}}
     {{$.Range .}}
-    {{$.TailHTML}}
-  {{end}}</body>
+  {{end}}{{$.TailHTML}}</body>
 </html>
 `
 
diff --git a/jawsboot/README.md b/jawsboot/README.md
@@ -70,3 +70,6 @@ assets
     ├── otherpage.html
     └── index.html
 ```
+
+Page templates rendered through `ui.Handler` should include `{{$.HeadHTML}}`
+inside `<head>` and `{{$.TailHTML}}` before the closing `</body>` tag.
diff --git a/jawstree/README.md b/jawstree/README.md
@@ -83,3 +83,6 @@ assets
     ├── otherpage.html
     └── index.html
 ```
+
+Page templates rendered through `ui.Handler` should include `{{$.HeadHTML}}`
+inside `<head>` and `{{$.TailHTML}}` before the closing `</body>` tag.

Original file line number	Diff line number	Diff line change
@@ -16,8 +16,7 @@ const indexhtml = `
`16`	`16`	`<head>{{$.HeadHTML}}</head>`
`17`	`17`	`<body>{{with .Dot}}`
`18`	`18`	`{{$.Range .}}`
`19`		`- {{$.TailHTML}}`
`20`		`- {{end}}</body>`
	`19`	`+ {{end}}{{$.TailHTML}}</body>`
`21`	`20`	`</html>`
`22`	`21`	`
`23`	`22`