       public init(rawValue: UInt8) { self.rawValue = rawValue }
       public let rawValue: UInt8
 
-      /// Do not remove null values from the resulting JSON value. Instead store `JSON.null`
+      /// Omit null values from `JSON.object`s & `JSON.array`s
       public static let skipNull        = Option(rawValue: 0b0001)
 
       /// Allows Parser to return top level objects that are not container types `{}` | `[]` as per RFC7159


  // TODO (vdka): refactor
  // TODO (vdka): option to _repair_ Unicode
  mutating func parseString() throws -> String {

    assert(peek() == quote)

    } while true
  }

  mutating func parseNumber() throws -> JSON {

    assert(numbers ~= peek()! || minus == peek()!)
