Comments on draft-snell-jsondoc-00

L26 Change Jan's email to algermissen@acm.org
L41 Missing '.'
L53 s/it's/its/g
L76 s/artifacts/syntax constructs/ (?)
L97 Should we explicitly define [ ] without modifier to mean 'optional but at most once' to capture the intention that most authors have anyway?
L116 I really like the ABNF rule 'feature', that was a brilliant idea you had!
L222 s/While, /While /
L226 We should specify which standard regex syntax is used by JSON Doc
L323 "all of the examples given deal specifically with providing" => "all of the examples explicitly provide"
L348 appears a little unclear to me; do you mean to say that the property 'definitions' are separated by commas?
L392 s/are//
L392,396 s/borrow/reference/ (?)
L409 s/"das ist die Deutsch version"/"das ist die deutsche Version"/ :-)
L432 Suppose one is writing a parser for JSON Doc - how does one detect that a line is a header line? Maybe we can prefix these lines?
L469 Maybe name Obj to TreeNode or similar to support the tree-like nature of the example (Obj is referenced in items)

Great work! Thank you.

Jan

jasnell / jsondoc