Make PathItem operation properties specific

[axelcostaspena]

PR for #2126.

Move the Operations properties definitions from patternProperties to the properties set, explicitly defining all of them. The goal is to get better coding tools completion - IntelliJ IDEA does - and to improve the spec quality with a purer spec schema usage.

Changes are 100% backwards compatible, all validating schemas will validate and all non validating schemas won't validate after merge. After merge, coding tools will get more information because of replacing a pattern with a defined literal set.

[handrews]

As the primary author of recent drafts of the JSON Schema spec, this is not an abuse of patternProperties. It's certainly valid to talk about what is most useful for tools, but it's a valid and useful technique as written.

[axelcostaspena]

@handrews your opinion is welcome :)

Never mind, #2126 specifically states that its nº 1 goal is better tool support. Also, commit message first line is about specificity.

[MikeRalphson]

Aye from me.

[MikeRalphson]

Danger Will Robinson! This PR is against the OpenAPI.next branch. I do not believe any merges are scheduled from this branch. @webron please advise correct branch (and maybe we can remove OpenAPI.next?

[axelcostaspena]

@MikeRalphson hmm sorry! Issue sems worse since the modification comes FROM OpenApi.next, which is unmerged into master. So let me solve it, I will create proper PR. But which work branch to choose? DEVELOPMENT.md:47 and README.md:24 seem to tell me to use 3.1.0-dev - non breaking change - instead of 3.0.3-dev - typos or clarifications - but none of that branch contain the v3 schema ¿?

[MikeRalphson]

That guidance is for changes to the specification. The schema is non-normative, so I think master should be OK.

[axelcostaspena]

@MikeRalphson PR source force updated
PR target updated.
Thank you for support on this.

[MikeRalphson]

Aye from me. Thanks for rebasing.

[karenetheridge]

Should this also be merged into v3.1/schema*, as the same keyword usage exists there?

[webron]

Wouldn't hurt...