Azure / Azure/azure-rest-api-specs

Enforce unified API versions in RP specs

Open
#28,466 5 comments 0 reactions 1 assignee Claimed by @mikeharder View on GitHub
Central-EngSys Spec PR Tools
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

Implement a tool to detect if any spec "tags" are mixing API versions.

If we name the parts of the path as follows:

```
Microsoft.Monitor/stable/2023-04-03/monitoringAccounts_API.json
///
```

We might want rules like:

* The `` of all files must be the same ("preview" or "stable")
* Within an ``, the of all files must be the same
* If `` is "preview", must end with "-preview". Else, `` must not end with "-preview".
* The `` of all files must match

Questions:

* Are versions required to be aligned across different ``?

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.