Added a linter for order of parameters.

[dblock]

Description

Require parameters to be sorted.

Here's a silly Ruby script to apply a sort for next linter that needs sorted something.

Dir["spec/**/*.yaml"].each do |filename|
    puts filename
    lines = []
    File.open(filename, "r") do |f|
        params = []
        in_params = false
        f.each_line do |line|
            if line.include?('parameters:')
                lines << line
                in_params = true
            elsif in_params && line.include?("- $ref: ")
                params << line
            elsif in_params && params.size > 0
                lines.concat(params.sort)
                lines << line
                params = []
                in_params = false
            else
                lines << line
            end
        end
    end
    File.open(filename, "w+") do |f|
        f.puts(lines)
    end
end

Issues Resolved

Closes #352.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

Changes Analysis

Commit SHA: d159d87
Comparing To SHA: ed3fb4d

API Changes

Summary

NO CHANGES

Report

The full API changes report is available at: https://github.com/opensearch-project/opensearch-api-specification/actions/runs/9717493002/artifacts/1649807241

API Coverage

	Before	After	Δ
Covered (%)	483 (47.31 %)	483 (47.31 %)	0 (0 %)
Uncovered (%)	538 (52.69 %)	538 (52.69 %)	0 (0 %)
Unknown	24	24	0

[dblock]

I put this back because to run an individual test you can't do npm run test:unit -- ...test.ts, it has testMatch flags, but you can do npm run jest -- ...test.ts.