Skip to content

Commit

Permalink
api-version policy
Browse files Browse the repository at this point in the history
  • Loading branch information
amarzavery authored Aug 11, 2016
1 parent b8cdc2c commit 8c0d4ff
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ This repository is the canonical source for REST API specifications for Microsof
## Creating the Swagger Specification for Azure
- This [document](./documentation/creating-swagger.md) will help you understand how AutoRest converts Swagger in to code.
- If you are using **swashbuckle** to generate a swagger spec from your .NET WEB API then please take a look at this [repo]( https://github.com/Azure/swashbuckle-resource-provider).
- Swagger spec for every api-version should be in a serate folder named with the api-version.
- It is time consuming to review the file line by line for every api-version. When you are creating the swagger spec for the new api-version, please copy the swagger spec from the previous version in to the new api-versioned folder and commit it. After that overwrite it with the changes for the new api-version. This makes it easy for us to review the changes.

## Directory Structure

Expand Down

0 comments on commit 8c0d4ff

Please sign in to comment.