openschema icon indicating copy to clipboard operation
openschema copied to clipboard

Published 20 hours ago • verified publisher icon openmessaging

[FIRST ROUND]Review Discussion

Open vongosling opened this issue 4 years ago • 0 comments

  • Spec descriptions should follow the rules: one-paragraph overview, parameter description, and use case.

  • Lack of the content negotiation in content types(application/json should be supported), we could provide multiple, weighted preferences:

Accept: application/vnd.openschema.v1+json; q=0.8, application/json; q=0.5

  • Error code should be defined. Or say, do we need to follow the RFC[1] ? In this way, we could provide the error validator template.

[1] https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1

vongosling avatar Jul 13 '21 01:07 vongosling