forked from Azure/azure-rest-api-specs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ec928bd
commit 28df1d5
Showing
1 changed file
with
79 additions
and
79 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,80 +1,80 @@ | ||
| [](https://travis-ci.org/Azure/azure-rest-api-specs) | ||
|
|
||
| # Azure REST API Specifications | ||
|
|
||
| ## Description | ||
|
|
||
| This repository is the canonical source for REST API specifications for Microsoft Azure. | ||
|
|
||
| ## Basics | ||
| If you're a spec author looking for information about all of of the repositories and steps in the pipeline, go to the [adx-documentation-pr](https://github.com/Azure/adx-documentation-pr) repository. Make sure to [join the Github Azure organization](http://aka.ms/azuregithub) to get access to that repo. | ||
|
|
||
| ## Getting started | ||
| - Our [Contribution guidelines](./.github/CONTRIBUTING.md) walks you through the process of contributing to this repository. | ||
| - The [/documentation](./documentation/) folder contains reference documentation for all aspects of Swagger and our recommended patterns. Start with the [Creating Swagger](./documentation/creating-swagger.md) page. | ||
|
|
||
| ## Directory Structure | ||
|
|
||
| The structure of the directory should strictly follow these rules: | ||
|
|
||
| 1. **Profile**: The profile holder contains the profiles' definition MD files. these files will contain information and references to the snapshots of the RPs' Resource types or Dataplane API versions that represent a specific profile. | ||
|
|
||
| 2. **Specification**: This folder the is root folder for all Specs (Management and Dataplane) related docs. | ||
|
|
||
| 3. **<RP-Name> Folders - each RP will have a seperate folder | ||
|
|
||
| 4. **'resource-manager' and 'data-plane' Folders**: the RPs can put specs in one of two categories: `resource-manager` (for ARM resources) and `data-plane` (for everything else) . The autorest configuration file (`readme.md`) for the RP should be inside this folder | ||
|
|
||
| 4. **API versions**: this folder will be the direct child of the category folder. there will be one such folder per resource type or dataplane service version. This folder will contain the OpenAPI validation Specs (Swaggers previously) and the examples folder. | ||
|
|
||
| 6. **Examples**: the example folder will contain the x-ms-examples files. it will reside under the APIs or Resources' version folders as different APIs or Resource types version can have different examples. | ||
|
|
||
| 7. **Notes**: | ||
| - folder names should be singular (ie, 'profile' not 'profiles' ) -- this removes ambiguity for some non-english speakers. | ||
| - generic folder names should be lower-case | ||
| - proper-name/product name/namespace folders can be PascalCased (ie, "KeyVault") | ||
| - files are whatever case you think is good for your soul. | ||
|
|
||
|
|
||
| The structure should appear like so: | ||
| ```bash | ||
| . | ||
| +---automation | ||
| | \---resource-manager | ||
| | \---Microsoft.Automation | ||
| | \---2015-10-31 | ||
| | \---examples | ||
| +---batch | ||
| | +---data-plane | ||
| | | \---Microsoft.Batch | ||
| | | +---2015-12-01.2.2 | ||
| | | +---2016-02-01.3.0 | ||
| | | +---2016-07-01.3.1 | ||
| | | +---2017-01-01.4.0 | ||
| | | | \---examples | ||
| | | \---2017-05-01.5.0 | ||
| | \---resource-manager | ||
| | \---Microsoft.Batch | ||
| | +---2015-12-01 | ||
| | +---2017-01-01 | ||
| | | \---examples | ||
| | \---2017-05-01 | ||
| | \---examples | ||
| +---billing | ||
| | \---resource-manager | ||
| | \---Microsoft.Billing | ||
| | +---2017-02-27-preview | ||
| | | \---examples | ||
| | \---2017-04-24-preview | ||
| | \---examples | ||
| └── readme.md | ||
| ``` | ||
|
|
||
| Currently, the specifications are expected to be in Swagger JSON format | ||
|
|
||
| ## Next steps | ||
| The next step in the process after a spec is completed is to generate SDKs and API reference documentation. Go to the [Azure Developer Experience guide](https://github.com/Azure/adx-documentation-pr) for more information. | ||
|
|
||
| --- | ||
| [](https://travis-ci.org/Azure/azure-rest-api-specs) | ||
|
|
||
| # Azure REST API Specifications | ||
|
|
||
| ## Description | ||
|
|
||
| This repository is the canonical source for REST API specifications for Microsoft Azure. | ||
|
|
||
| ## Basics | ||
| If you're a spec author looking for information about all of of the repositories and steps in the pipeline, go to the [adx-documentation-pr](https://github.com/Azure/adx-documentation-pr) repository. Make sure to [join the Github Azure organization](http://aka.ms/azuregithub) to get access to that repo. | ||
|
|
||
| ## Getting started | ||
| - Our [Contribution guidelines](./.github/CONTRIBUTING.md) walks you through the process of contributing to this repository. | ||
| - The [/documentation](./documentation/) folder contains reference documentation for all aspects of Swagger and our recommended patterns. Start with the [Creating Swagger](./documentation/creating-swagger.md) page. | ||
|
|
||
| ## Directory Structure | ||
|
|
||
| The structure of the directory should strictly follow these rules: | ||
|
|
||
| 1. **Profile**: The profile holder contains the profiles' definition MD files. these files will contain information and references to the snapshots of the RPs' Resource types or Dataplane API versions that represent a specific profile. | ||
|
|
||
| 2. **Specification**: This folder the is root folder for all Specs (Management and Dataplane) related docs. | ||
|
|
||
| 3. **<RP-Name>** Folders - each RP will have a seperate folder | ||
|
|
||
| 4. **'resource-manager' and 'data-plane' Folders**: the RPs can put specs in one of two categories: `resource-manager` (for ARM resources) and `data-plane` (for everything else) . The autorest configuration file (`readme.md`) for the RP should be inside this folder | ||
|
|
||
| 4. **API versions**: this folder will be the direct child of the category folder. there will be one such folder per resource type or dataplane service version. This folder will contain the OpenAPI validation Specs (Swaggers previously) and the examples folder. | ||
|
|
||
| 6. **Examples**: the example folder will contain the x-ms-examples files. it will reside under the APIs or Resources' version folders as different APIs or Resource types version can have different examples. | ||
|
|
||
| 7. **Notes**: | ||
| - folder names should be singular (ie, 'profile' not 'profiles' ) -- this removes ambiguity for some non-english speakers. | ||
| - generic folder names should be lower-case | ||
| - proper-name/product name/namespace folders can be PascalCased (ie, "KeyVault") | ||
| - files are whatever case you think is good for your soul. | ||
|
|
||
|
|
||
| The structure should appear like so: | ||
| ```bash | ||
| . | ||
| +---automation | ||
| | \---resource-manager | ||
| | \---Microsoft.Automation | ||
| | \---2015-10-31 | ||
| | \---examples | ||
| +---batch | ||
| | +---data-plane | ||
| | | \---Microsoft.Batch | ||
| | | +---2015-12-01.2.2 | ||
| | | +---2016-02-01.3.0 | ||
| | | +---2016-07-01.3.1 | ||
| | | +---2017-01-01.4.0 | ||
| | | | \---examples | ||
| | | \---2017-05-01.5.0 | ||
| | \---resource-manager | ||
| | \---Microsoft.Batch | ||
| | +---2015-12-01 | ||
| | +---2017-01-01 | ||
| | | \---examples | ||
| | \---2017-05-01 | ||
| | \---examples | ||
| +---billing | ||
| | \---resource-manager | ||
| | \---Microsoft.Billing | ||
| | +---2017-02-27-preview | ||
| | | \---examples | ||
| | \---2017-04-24-preview | ||
| | \---examples | ||
| └── readme.md | ||
| ``` | ||
|
|
||
| Currently, the specifications are expected to be in Swagger JSON format | ||
|
|
||
| ## Next steps | ||
| The next step in the process after a spec is completed is to generate SDKs and API reference documentation. Go to the [Azure Developer Experience guide](https://github.com/Azure/adx-documentation-pr) for more information. | ||
|
|
||
| --- | ||
| _This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments._Folder PATH listing for volume Windows | ||
|
|
||
|
|