Azure / Azure/azure-openapi-validator

Overloading with x-ms-paths

Open
#130 0 comments 0 reactions 0 assignees View on GitHub
planned
Dominant language
TypeScript
Stars
53
Forks
57
Avg merge
1d 23h
Merged PRs (30d)
2

Description

Is not always very smart and complains about errors that are not there.
The semantic validator will complain about something like this...
``` json
"paths": {
"/{a}": {
"stuff from operation a"
},
"/{b}": {
"stuff from operation b"
}
}
```
Which makes sense, it is somewhat ambiguous. This can be fixed with `x-ms-paths` like this...
``` json
"paths": {
"/{a}": {
"stuff from operation a"
}
}
"x-ms-paths": {
"/{b}?overload=dummy": {
"stuff from operation b"
}
}
```
But in this case, the linter will complain about operation `b`, because apparently, it is not overloading anything. The linter should be smarter in this case.
This issue happened [here](https://travis-ci.org/Azure/azure-rest-api-specs/jobs/305442978#L802)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.