Even further with Tag...

README.md

@@ -74,35 +74,54 @@ That's it.
 
 ## Creating custom tags
 
-You can define your own custom tags by subclassing the `Tag` or `EmptyTag` class. 
+You can define your own custom tags a few different ways, from simple to complex cases.
 
-You can follow the same pattern if you take a look at the core tags.
+1. Subclass `Tag` and it will render with your class name lowercased.
 
 ```swift
-open class Div: Tag {
+class MyTag: Tag { }
 
+// <mytag></mytag>
+```
+
+2. Subclass `Tag` and override the `name` property.
+
+```swift
+class MyTag: Tag { 
+
+    override open class var name: String { "myTag" }
 }
 
-// <div></div> - standard tag
+// <myTag></myTag>
+```
+
+3. Subclass `Tag` and override the `type` property. `Type` determines how your class will render. For example, to create an empty tag...
 
-open class Br: EmptyTag {
+```swift
+class MyTag: Tag {
 
+    override open class var type: `Type` { .empty }
 }
-// <br> - no closing tag
 
+// <myTag>
 ```
 
-By default the name of the tag is automatically derived from the class name (lowercased), but you can also create your own tag type & name by overriding the `createNode()` class function.
+4. Subclass `Tag`, create your own custom initializer and then call the `Tag` designated initializer.
 
 ```swift
-open class LastBuildDate: Tag {
-
-    open override class func createNode() -> Node {
-        Node(type: .standard, name: "lastBuildDate")
+class MyTag: Tag {
+
+    init(myAttributeValue: String, @TagBuilder _ builder: () -> Tag) {
+        let attribute = .init(key: "myKey", value: myAttributeValue)
+        super.init(type: .empty,
+                   name: "myTag",
+                   attributes: [attribute],
+                   builder: [builder()]
+        )
     }
 }
 
-// <lastBuildDate></lastBuildDate> - standard tag with custom name
+// <myTag myKey="myAttributeValue">
 ```
 
 It is also possible to create tags with altered content or default attributes.
@@ -129,6 +148,50 @@ open class Rss: Tag {
 // <rss version="2.0">...</rss> - tag with a default attribute
 ```
 
+To customize tags of a particular `Node` type...
+
+```swift
+// Bracketed tags... <tagname></tagname> ...use StandardTag class
+class MyClass: StandardTag { }
+
+// Single tag... <tagname> ...use EmptyTag class
+class MyClass: EmptyTag { }
+
+// Comment tag... <!-- your comments here --> ...use CommentTag class
+class MyClass: CommentTag { }
+```
+
+When you need to combined multiple tags into one, but don't want the container to render, use the `GroupTag`. This class is especially handy when a function parameter requires one `Tag` but you need to supply many.
+
+```swift
+class MyTag: Tag {
+
+    init(myAttributeValue: String, @TagBuilder _ builder: () -> Tag) {
+        let attribute = .init(key: "myKey", value: myAttributeValue)
+        let node = Node(type: .empty, name: "myTag", attributes: [attribute])
+        super.init(node: node, [builder()])
+    }
+
+    convenience init(anotherValue: String) {
+        self.init(myAttributeValue: anotherValue) {
+            // must return one Tag for builder parameter
+            // use GroupTag because it will not render 
+            GroupTag {
+                TagA()
+                TagB()
+                TagC()
+            }
+        }
+    }
+}
+
+//  <taga></taga>
+//  <tagb></tagb>
+//  <tagc></tagc>
+```
+
+If you just need to render basic HTML — `<div>`, `<p>`, `<a>`, etc. — then use one the many pre-made classes in the library called by the same name.
+
 ## Attribute management
 
 You can set, add or delete the attributes of a given tag.