Meta schema 3.1 is wrong for path / pathItem

[LasneF]

Accordinf to https://spec.openapis.org/oas/latest.html#fixed-fields-6

Path item Object should support $ref as in the snippet below

paths:
    /orders:
         $ref: paths/orders.yaml

it looks not supported in the meta schema
https://github.com/OAI/OpenAPI-Specification/blob/main/schemas/v3.1/schema.yaml#L211

to me the line 209 is wrong

      '^/':
        $ref: '#/$defs/path-item'

but should be

      '^/':
        $ref: '#/$defs/path-item-or-reference:'

this has been found here : daveshanley/vacuum#422

[handrews]

Thanks, @LasneF. This is a dup of #3298 and is addressed by PR #3355, which (like all not-yet-deployed schema PRs — technically only the Schema Object portion is a metaschema) is awaiting proper resolution to #151 (comment). Which we expect to actually have fairly soon as it's part of the big clean-up we're doing on the issue/PR/process backlog as discussed in the TDC calls this month.

[LasneF]

not 100 % sure read the PR correctly path-item-or-reference: is removed
so does it means

• that $ref syntax provided is not be supported , ie having path item definition in dedicated files is forbidden
  using $ref more or less like an include the targeted files containing only content of path-item

or

• the $ref is by default supported no need to have dedicated syntax for it

should the docuementation https://spec.openapis.org/oas/latest.html#fixed-fields-6 being updated ?

[handrews]

@LasneF PathItem is a special case for referencing which uses a different syntax/semantics for adjacent properties. So PR #3355 deletes #/$defs/path-item-or-references, adds $ref directly to #/$defs/path-item, and replaces #/$defs/path-item-or-reference with #/$defs/path-item wherever it had appeared.