How microsoft/api-guidelines works
This repository is a documentation product: it helps API teams find general Microsoft REST guidance, then directs Azure and Microsoft Graph teams to specialized guidance. The Graph branch also includes a pattern catalog. Relationships below are limited to those stated in the README; individual pattern contents and links within the catalogs were not sampled, so they are not expanded.
Main entry points: README.md Repository overview · GuidelinesGraph.md Graph guidelines · azure/README.md Azure overview · Guidelines.md Azure guidelines
Components 7
General Guidance
- Repository overview
README.md
Azure Guidance
- Azure overview
azure/README.md - Azure guidelines
azure/Guidelines.md - Service design
azure/ConsiderationsForServiceDesign.md
Graph Guidance
- Graph guidelines
graph/GuidelinesGraph.md - Pattern catalog
graph/patterns
Other components
- API teams
Connections 6
- API teams → Repository overview: find guidance
README.md - Repository overview → Azure guidelines: directs Azure teams
README.md - Repository overview → Service design: directs Azure teams
README.md - Repository overview → Azure overview: refers for details
README.md - Repository overview → Graph guidelines: directs Graph teams
README.md - Graph guidelines → Pattern catalog: pairs with catalog
README.md