[Koha-bugs] [Bug 30194] Update required JSON::Validator version

bugzilla-daemon at bugs.koha-community.org bugzilla-daemon at bugs.koha-community.org
Thu Mar 17 11:44:14 CET 2022


https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=30194

--- Comment #30 from Jonathan Druart <jonathan.druart+koha at gmail.com> ---
https://swagger.io/docs/specification/using-ref/

"""
Places Where $ref Can Be Used
A common misconception is that $ref is allowed anywhere in an OpenAPI
specification file. Actually $ref is only allowed in places where the OpenAPI
3.0 Specification explicitly states that the value may be a reference. For
example, $ref cannot be used in the info section and directly under paths:

    openapi: 3.0.0
    # Incorrect!
    info:
      $ref: info.yaml
    paths:
      $ref: paths.yaml

However, you can $ref individual paths, like so:

    paths:
      /users:
        $ref: '../resources/users.yaml'
      /users/{userId}:
        $ref: '../resources/users-by-id.yaml'
"""

The fix does not seem hard to implement, why aren't we doing that?

-- 
You are receiving this mail because:
You are watching all bug changes.


More information about the Koha-bugs mailing list