Azure / Azure/azure-dev

Set up agentic workflows to keep documentation healthy

Open
#7,165 0 comments 0 reactions 1 assignee Assigned to @richardpark-msft View on GitHub
area/core-cli engineering item
Dominant language
Go
Stars
569
Forks
364
Avg merge
2d 19h
Merged PRs (30d)
136

Description

## Summary

As we improve the repository documentation structure, we should also establish agentic workflows that help keep docs healthy over time.

## Focus

- Use coding agents to help identify stale documentation paths, missing cross-links, and areas that lack clear ownership
- Establish lightweight maintenance routines for documentation health
- Make it easier to catch drift between the codebase and the docs surface
- Support a more regular cadence of documentation cleanup and improvement

## Outcomes

- Documentation stays easier to navigate over time
- Common documentation issues are identified earlier
- Contributors have clearer signals when docs need attention
- The long-term docs architecture remains healthier as the repo evolves

Parent issue: #7164

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.