From dbd6555791a6d770fbd4010fa370d2a0d208d754 Mon Sep 17 00:00:00 2001
From: DarkWiiPlayer <darkwiiplayer@hotmail.com>
Date: Mon, 22 Jan 2024 10:30:56 +0100
Subject: [PATCH] [WIP] Write some more about the HTML proxy

---
 doc/html-proxy.md | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/doc/html-proxy.md b/doc/html-proxy.md
index 95b4b24..16cbd8c 100644
--- a/doc/html-proxy.md
+++ b/doc/html-proxy.md
@@ -4,8 +4,7 @@
 import {html} from "skooma.js"
 ```
 
-A functional-friendly helper library for procedural DOM generation and
-templating, with support for reactive state objects.
+A functional-friendly helper library for procedural DOM generation and templating, with support for reactive state objects.
 
 ## Overview
 
@@ -24,19 +23,26 @@ document.body.append(html.div(
 
 ### Basic DOM generation
 
-Accessing the `html` proxy with any string key returns a new node generator function:
+Accessing the `html` proxy with any string key returns a new node generator function. When called this function will generate a DOM node (HTML Tag). The name of the function becomes the tag name of the node.
 
 ```js
-html.div("Hello, World!")
+html.div()
 ```
 
-Attributes can be set by passing objects to the generator:
+Content and attributes can be set via the function arguments: Strings and DOM nodes are inserted as children, while other objects (except for some special cases) have their key-value pairs turned into attribute-value pairs on the 
 
 ```js
 html.div("Big Text", {style: "font-size: 1.4em"})
 ```
 
-Complex structures can easily achieved by nesting generator functions:
+Arrays, including nested ones, are iterated, and their values treated as arguments. This works both for inserting children and setting attributes.
+
+```js
+const content = [" ps: hi", {class: "title"}]
+html.h1({id: "main-heading"}, "Heading", content)
+```
+
+Nested tags can be generated with nested function calls:
 
 ```js
 html.div(