Folder Structure

Table of Contents

• Overview

Overview

Specifications in this repository must organize their files and folders according to strict guidelines.

In June 2025, the guidelines were updated to version 2. New specs are encouraged to start with v2, and existing specs are encouraged to convert to v2 when convenient. The widget sample uses v2.

Prior to June 2025, all specs were using v1. The contosowidgetmanager sample uses v1.

Versions

Version 2 (June 2025)

TBD

Version 1

https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/typespec-structure-guidelines.md