docs: add AI-assisted engineering & HVE guidance and fix outdated links#1133
Open
vdstrizhkova wants to merge 3 commits into
Open
docs: add AI-assisted engineering & HVE guidance and fix outdated links#1133vdstrizhkova wants to merge 3 commits into
vdstrizhkova wants to merge 3 commits into
Conversation
added 3 commits
July 16, 2026 09:16
- align wording and tone across observability, security, code-review, and other docs - fix outdated/broken external links and dead references - add cspell terms, gitignore/gitattributes, and mkdocs workflow action bumps 📝 - Generated by Copilot
- lychee surfaces a backlog of pre-existing broken/blocked external links - keep it disabled (as in the source PR) until that backlog is triaged 🔧 - Generated by Copilot
- add AI-assisted engineering hub (docs/ai-assisted-engineering/README.md) - add generative-AI and agentic systems guidance, including HVE references 🤖 - Generated by Copilot
vdstrizhkova
changed the title
This was referenced Jul 16, 2026
vdstrizhkova
changed the title
vdstrizhkova
marked this pull request as ready for review
July 16, 2026 17:00
vdstrizhkova
requested review from
TessFerrandez,
nyouens and
shiranr
as code owners
July 16, 2026 17:00
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request Template
What are you trying to address
This is part 1 of 3 splitting the large PR #1130 into focused, independently reviewable changes. It adds the AI-assisted engineering and HVE guidance to the playbook and fixes outdated links. Structural/navigation changes are in #1134; the tone-of-voice guarding automation is in #1135.
Scope: 51 files changed (+836 / -101).
AI & HVE additions
docs/ai-assisted-engineering/README.md- AI-assisted engineering hub.docs/ml-and-ai-projects/generative-ai-and-agentic-systems.md- generative-AI and agentic systems guidance.microsoft/hve-core) as a reusable prompt/agent/skill accelerator.developer-experience/copilots.md,ml-and-ai-projects/README.md,model-experimentation.md,responsible-ai.md, andobservability/ml-observability.md.Related content & link fixes
Supporting config
.cspell.json(technical terms),.gitignore,.gitattributes,.github/workflows/mkdocs.yml(GitHub Actions version bumps),requirements-docs.txt..mega-linter.ymlkeepsSPELL_LYCHEEdisabled (matching docs: restructure playbook & add AI-assisted engineering guidance #1130); the link checker surfaces a pre-existing backlog of blocked/broken external links unrelated to this change. Thelychee.tomlchanges from docs: restructure playbook & add AI-assisted engineering guidance #1130 are intentionally excluded to keep scope minimal.Checklist
READY TO PR? Use the check-list below to ensure your branch is ready for PR.