Skip to content

Develop semantic model of specs repo dir structure #8203

@konrad-jamrozik

Description

@konrad-jamrozik

There has been ongoing work for reviewing, updating and codifying the set of rules on what spec directory structure is allowed to be going forward. Current status is captured here:

This work item is about:

  • Aiding the process of determining the allowed directory structure by gathering relevant data.
  • Leveraging that work in form of a reusable software component for all the spec PR validation tools.

Note: azure-sdk issues labelled with specs-model should be addressed by this work.

Inputs:

Output:

  • Implementation of rules captured in https://aka.ms/azsdk/spec-dirs, with analysis of existing directories:
    • which directory is for service vs service group
    • details of all the services
    • which directory is violating the rules, how long it has been doing it (is it relatively new or legacy/brownfield?) and how exactly it is violating the rules (to determine if the rules perhaps require adjustment)

Metadata

Metadata

Labels

Central-EngSysThis issue is owned by the Engineering System team.Spec PR ToolsTooling that runs in azure-rest-api-specs repo.specs-modelIssues requiring logic to be implemented by https://github.com/Azure/azure-sdk-tools/issues/8203

Type

No type

Projects

Status

📋 Backlog

Status

🐝 In Progress

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions