Moved Examples.swift into a Playground, added some initialization code required to create entities and documents in code.

JSONAPI.playground/Sources/Entities.swift

@@ -0,0 +1,85 @@
+//
+//  Examples.swift
+//  JSONAPI
+//
+//  Created by Mathew Polzin on 11/12/18.
+//
+
+import Foundation
+import JSONAPI
+
+/*******
+
+Please enjoy these examples, but allow me the forced casting and the lack of error checking for the sake of brevity.
+
+********/
+
+// MARK: - String as CreatableRawIdType
+var GlobalStringId: Int = 0
+extension String: CreatableRawIdType {
+	public static func unique() -> String {
+		GlobalStringId += 1
+		return String(GlobalStringId)
+	}
+}
+
+// MARK: - Entity typealias for convenience
+public typealias ExampleEntity<Description: EntityDescription> = Entity<Description, Id<String, Description>>
+
+// MARK: - A few resource objects (entities)
+public enum PersonDescription: EntityDescription {
+
+	public static var type: String { return "people" }
+	
+	public struct Attributes: JSONAPI.Attributes {
+		public let name: Attribute<[String]>
+		public let favoriteColor: Attribute<String>
+	}
+	
+	public struct Relationships: JSONAPI.Relationships {
+		public let friends: ToManyRelationship<Person>
+		public let dogs: ToManyRelationship<Dog>
+		public let home: ToOneRelationship<House>
+	}
+}
+
+public typealias Person = ExampleEntity<PersonDescription>
+
+public extension Entity where Description == PersonDescription, Identifier == Id<String, PersonDescription> {
+	public init(name: [String], favoriteColor: String, friends: [Person], dogs: [Dog], home: House) throws {
+		self = try Person(attributes: .init(name: .init(rawValue: name), favoriteColor: .init(rawValue: favoriteColor)), relationships: .init(friends: .init(entities: friends), dogs: .init(entities: dogs), home: .init(entity: home)))
+	}
+}
+
+public enum DogDescription: EntityDescription {
+
+	public static var type: String { return "dogs" }
+
+	public struct Attributes: JSONAPI.Attributes {
+		public let name: Attribute<String>
+	}
+
+	public struct Relationships: JSONAPI.Relationships {
+		public let owner: ToOneRelationship<Person?>
+	}
+}
+
+public typealias Dog = ExampleEntity<DogDescription>
+
+public extension Entity where Description == DogDescription, Identifier == Id<String, DogDescription> {
+	public init(name: String, owner: Person?) throws {
+		self = try Dog(attributes: .init(name: .init(rawValue: name)), relationships: DogDescription.Relationships(owner: .init(entity: owner)))
+	}
+}
+
+public enum HouseDescription: EntityDescription {
+
+	public static var type: String { return "houses" }
+
+	public typealias Attributes = NoAttributes
+	public typealias Relationships = NoRelatives
+}
+
+public typealias House = ExampleEntity<HouseDescription>
+
+