Add AI-assisted development documentation section#3259
Open
jfversluis wants to merge 8 commits intomainfrom
Open
Add AI-assisted development documentation section#3259jfversluis wants to merge 8 commits intomainfrom
jfversluis wants to merge 8 commits intomainfrom
Conversation
New section with 6 guides covering: - Overview of AI tooling for MAUI development - Writing effective copilot-instructions.md - Custom instruction files (.github/instructions/) - .NET Agent Skills marketplace - MauiDevFlow for AI-assisted debugging - Best practices for AI-friendly project structure Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Fixes from 6 personas (junior dev, senior architect, tech editor, Xamarin migrator, DevOps engineer, OSS contributor): - Fix broken cross-links (agent-skills.md → skills.md, etc.) - Add security notes for DevFlow (dev-only, port exposure) - Clarify .ios.cs/.maccatalyst.cs Mac Catalyst overlap with WARNING - Add contributor guidance (read AGENTS.md before PRing) - Add Xamarin.Forms migration subsection - Fix nested code blocks, TFM consistency notes - Standardize terminology to 'AI coding assistant' - Add CI/enterprise considerations throughout Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Fixes from iOS dev, tech writer, AI engineer, principal engineer, accessibility personas: - Add .NET explanations for Swift/iOS newcomers (partial classes, TFMs, DI) - Add screen-reader text descriptions before ASCII art structures - Replace emoji in code with plain text for accessibility - Add text status column to platform support table - Consolidate excessive callouts in devflow.md - Add MCP tool categories and Xcode/DevTools comparison - Add 'How skills complement instruction files' section - Reduce cross-page redundancy with links - Recommend devcontainers for team-wide skill installation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Fixes from skeptic, Blazor dev, QA bot, UX researcher, cross-platform dev personas: - Replace overselling language with measured claims - Add 'Choose your path' routing block to index - Add Blazor Hybrid subsections (copilot-instructions, best-practices, devflow) - Add template jump-link for quick access - Remove hardcoded padding values for platform-safe guidance - Simplify DevFlow port binding docs - Add CDP snapshot Blazor debugging workflow Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix orphaned .editorconfig section in best-practices.md - Remove duplicate macOS/Mac Catalyst platform listing - Add Linux/GTK setup notes in devflow.md - Improve best-practices.md opening paragraph Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix UseSafeArea applied to Grid instead of ContentPage - Remove placeholder GitHub issue URL Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
- Change ms.topic from 'concept' to 'conceptual' (best-practices.md) - Change ms.topic from 'concept' to 'overview' (index.md) - Rename devflow.md to dev-flow.md (filename-incomplete warning) - Update all cross-references to new filename Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
Contributor
|
Learn Build status updates of commit b68993e: ✅ Validation status: passed
For more details, please refer to the build report. |
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.
Summary
Adds a new AI-assisted development section to the .NET MAUI docs with 6 guides covering how to set up a MAUI repository for effective AI-assisted development.
New pages
index.mdcopilot-instructions.md.github/copilot-instructions.mdfor MAUI projectscustom-instructions.md.github/instructions/*.instructions.mdfiles andAGENTS.mdskills.mddotnet-mauiplugindevflow.mdbest-practices.mdKey topics covered
.ios.cs,.android.cs, Mac Catalyst compilation rules)Review process
These guides went through 5 rounds of multi-model review with 11 different developer personas (junior dev, senior architect, tech editor, iOS migrant, DevOps engineer, OSS contributor, Blazor dev, accessibility reviewer, UX researcher, cross-platform dev, AI/ML engineer) across 8 AI models. Final round: Approved for publication with no blockers.
TOC placement
New section appears between "Artificial intelligence" and "Deployment & testing" in the main TOC.
Internal previews