Problem
The repository contains 9 README files with 50+ links (internal and external) that need comprehensive validation to ensure:
- All internal relative paths resolve correctly
- External URLs are accessible (no 404s)
- Microsoft URLs don't contain language-specific paths (
/en-us/)
- Frontmatter is valid across all files
Files to Audit
| File |
Links |
Priority |
README.md |
16 |
High |
.github/chatmodes/README.md |
1 |
Medium |
.github/instructions/README.md |
1 |
Medium |
.github/prompts/README.md |
26 |
High |
.github/workflows/README.md |
5 |
Medium |
.devcontainer/README.md |
4 |
Medium |
.vscode/README.md |
3 |
Critical (missing frontmatter) |
scripts/README.md |
4 |
Low |
scripts/linting/README.md |
3 |
Low |
Known Issues
Critical
Validation Required
Validation Process
- Run existing link validation:
npm run lint:md-links
- Run language path check:
npm run lint:link-lang
- Manual verification of relative path resolution
- Fix
.vscode/README.md frontmatter
Acceptance Criteria
Problem
The repository contains 9 README files with 50+ links (internal and external) that need comprehensive validation to ensure:
/en-us/)Files to Audit
README.md.github/chatmodes/README.md.github/instructions/README.md.github/prompts/README.md.github/workflows/README.md.devcontainer/README.md.vscode/README.mdscripts/README.mdscripts/linting/README.mdKnown Issues
Critical
.vscode/README.md- Missing YAML frontmatter withtitle:field (has code fence header instead)Validation Required
../relative paths resolve correctly/en-us/language pathsValidation Process
npm run lint:md-linksnpm run lint:link-lang.vscode/README.mdfrontmatterAcceptance Criteria
.vscode/README.mdhas valid YAML frontmatter