-
Notifications
You must be signed in to change notification settings - Fork 4
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Fragment identifier for yaml and +yaml #21
Comments
It seems strange to me that a media type would define a new "language" intrinsic. |
I believe the registration should include the fragment identifier. +json does not identify one, which creates problems. It probably should have a registration update to address it. Not registering fragment handling means that a reference to a YAML-borne schema cannot be referenced. The part beyond the # would be formally nonsensical (as it is today). We can take some inspiration from the work on the same issue for JSON Schema. JSON Pointer tells us how to craft fragments. The same format applies to the semantic equivalent in YAML documents. I'll put in a pull request. |
@cjaccino we have splitted the two documents. I think that yaml fragment identifiers should probably be delegated to "structured" media types since there are multiple possibilities (eg. json-path, json pointers, ...) WRT openapi+yaml for example, we can state that the fragment uses json pointers. |
@eemeli Can you confirm that the YAML community agrees with the current statement wrt fragment identifiers? |
I'm pretty sure that fragment identifiers should not be defined for So while YAML 1.1 and 1.2 do explicitly support On the other hand, defining fragment identifiers for |
FWIW, I completely agree. |
The choice to leave the fragment identifier of the structured syntax suffix to the media type is sensible: I will PR that. |
* Define fragment identifiers for application/yaml * Use first match when alias targets are not unique * Update draft-ietf-httpapi-yaml-mediatypes.md Co-authored-by: Roberto Polli <robipolli@gmail.com> * Fix: #21. Fragment identifiers. * typos * Update draft-ietf-httpapi-yaml-mediatypes.md Co-authored-by: Roberto Polli <robipolli@gmail.com>
Question
Compile fragment identifier section
yaml
+yaml
? See: #21. +yaml fragment identifier. #39Can we pospone this?
The text was updated successfully, but these errors were encountered: