Update to 10.4 "Output Structure"

[bwicklund]

Per the following issue: #824

[gregsdennis]

To be clear, there's not a typo in the text. This is about vertices not being defined.

[gregsdennis]

These are informal errors intended for the prose explanation of the output, not errors as they would be generated by an implementation. It's fine for them to have semantic information about the schema.

"Vertices" is probably left over from an earlier draft of this section while I wrote it.

@Relequestual what's the process for changes like these? Does this go into a "draft 2019-12” or whatever the next minor iteration is?

[Relequestual]

Interesting case here.
What would happen if the $ref was inlined?
You would then only know what "it" was based on any provided annotations, for example title.
Alterntativly, use properties key, OR, say "at the document root".
My feeling is the correct "fix" for this would be to include the annotation.
Additionally, we could suggest a workflow for determining the subject of the error.

Later in 10.4.2, we give the BASIC output with the error "Expected at least 3 items but found 2".

Maybe the mentioned error message was simply not sanity checked.
Either way, the ISSUE is correct, but I'm not sure on the intent or the best resolution right now.

[Relequestual]

In terms of "what's the process", let's open a new issue and get it defined properly =]

[handrews]

@gregsdennis I tried really hard to get all of the example lines within the limits of the IETF text rendering format, or at least down to only giving specification build warnings instead of errors. I'm fairly certain I changed it to "points" to save a few letters and must have missed "vertices" here.

[handrews]

@Relequestual @gregsdennis the process is to tag these things with the appropriate milestone, which would be draft-08-patch1. Which I've been doing as appropriate since 2019-09 was published. See also the big table at https://json-schema.org/specification-links.html which records milestones along with every other type of version thingy we use.

[Relequestual]

I think two is the magic number here...