With the spec docs now in markdown and with us self-hosting the files, should we move to having links go directly to their targets rather than to an appendix (which is IETF style)? Personally, I never liked linking to an appendix.

travanichagul / trawanichagul-gmail.com

0 stars 0 forks source link

With the spec docs now in markdown and with us self-hosting the files, should we move to having links go directly to their targets rather than to an appendix (which is IETF style)? Personally, I never liked linking to an appendix. #1

Open travanichagul opened 1 month ago

travanichagul commented 1 month ago

With the spec docs now in markdown and with us self-hosting the files, should we move to having links go directly to their targets rather than to an appendix (which is IETF style)? Personally, I never liked linking to an appendix.

OpenAPI uses direct links, which you can see with the JSON Schema spec link in Section 4.4.

Originally posted by @gregsdennis in https://github.com/json-schema-org/json-schema-spec/issues/1536

gregsdennis commented 1 month ago

What is this? Why tag me? Why not just follow the issue?