Azure / Azure/azure-dev

Automate updating azure.yaml schema docs at release time whenever azure.yaml.json schema changes

Open
#9,159 0 comments 0 reactions 0 assignees View on GitHub
agentic-workflows area/docs
Dominant language
Go
Stars
569
Forks
364
Avg merge
2d 19h
Merged PRs (30d)
136

Description

It would be nice if we could leverage automated agentic workflows to update https://learn.microsoft.com/azure/developer/azure-developer-cli/azd-schema at release time whenever the [azure.yaml.json schema](https://github.com/Azure/azure-dev/blob/main/schemas/v1.0/azure.yaml.json) changes

Contributor guide

Open the contributing guide

Research direction

Start with schemas/v1.0/azure.yaml.json and the linked Azure schema documentation at learn.microsoft.com, then inspect the repository's release automation and existing documentation update process. Done means a release-time workflow detects schema changes and updates the azure.yaml schema docs consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure
Domain
ci-cd, documentation, release
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.