High-level base documentation is complete.

Examples and every model completed, 1/6th of the way through models.

datamodel/high/base/xml.go

@@ -4,32 +4,38 @@
 package base
 
 import (
-	"github.com/pb33f/libopenapi/datamodel/high"
-	low "github.com/pb33f/libopenapi/datamodel/low/base"
+    "github.com/pb33f/libopenapi/datamodel/high"
+    low "github.com/pb33f/libopenapi/datamodel/low/base"
 )
 
+// XML represents a high-level representation of an XML object defined by all versions of OpenAPI and backed by
+// low-level XML object.
+//  v2 - https://swagger.io/specification/v2/#xmlObject
+//  v3 - https://swagger.io/specification/#xml-object
 type XML struct {
-	Name       string
-	Namespace  string
-	Prefix     string
-	Attribute  bool
-	Wrapped    bool
-	Extensions map[string]any
-	low        *low.XML
+    Name       string
+    Namespace  string
+    Prefix     string
+    Attribute  bool
+    Wrapped    bool
+    Extensions map[string]any
+    low        *low.XML
 }
 
+// NewXML creates a new high-level XML instance from a low-level one.
 func NewXML(xml *low.XML) *XML {
-	x := new(XML)
-	x.low = xml
-	x.Name = xml.Name.Value
-	x.Namespace = xml.Namespace.Value
-	x.Prefix = xml.Namespace.Value
-	x.Attribute = xml.Attribute.Value
-	x.Wrapped = xml.Wrapped.Value
-	x.Extensions = high.ExtractExtensions(xml.Extensions)
-	return x
+    x := new(XML)
+    x.low = xml
+    x.Name = xml.Name.Value
+    x.Namespace = xml.Namespace.Value
+    x.Prefix = xml.Namespace.Value
+    x.Attribute = xml.Attribute.Value
+    x.Wrapped = xml.Wrapped.Value
+    x.Extensions = high.ExtractExtensions(xml.Extensions)
+    return x
 }
 
+// GoLow returns the low level XML reference used to create the high level one.
 func (x *XML) GoLow() *low.XML {
-	return x.low
+    return x.low
 }