Azure / Azure/azure-dev

S-1: Registry Governance Documentation

Open
#7,849 1 comment 0 reactions 0 assignees View on GitHub
area/core-cli epic
Dominant language
Go
Stars
569
Forks
364
Avg merge
2d 19h
Merged PRs (30d)
136

Description

## Problem / User Value

Partner teams at Microsoft need a clear, documented process for submitting their tools to the azd registry. Without a governance model, the registry becomes ungoverned — either no one knows how to contribute, or tools are added without quality review, leading to stale or broken entries.

## Definition of Done

Governance document published at `docs/design/azd-tool/registry-governance.md` with ownership, approval process, SLA, contribution template, and ingestion process.

## Tasks

- [ ] **S-1: Write registry governance documentation** (S) — Create `docs/design/azd-tool/registry-governance.md` documenting: registry ownership (azd team), approval process (PR review by azd maintainers), SLA for additions (<5 business days), ingestion model (PR with YAML entry + test validation), contribution template with all required fields. Reference `pkg/extensions/registry.go` as prior art for the extension registry model.
- AC: Governance doc published; ownership/approval/SLA clearly defined; contribution template included with all required fields; ingestion process described (PR-based with CI validation); document reviewed and approved by team

## Sequencing

No dependencies — can start immediately and run in parallel with any other work.

## Dependencies

None. This is a standalone documentation task with no code dependencies.

## Discussion Traceability

| Discussion Item | Task |
|---|---|
| S1 (registry curation) | S-1 |

## Design References

- `docs/design/azd-tool/plan.md` — Standalone Tasks
- `docs/design/azd-tool/todos.md` — S-1 acceptance criteria
- `pkg/extensions/registry.go` — prior art for extension registry model

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.