Skip to content

Document what's new moniker exception #3355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jfversluis wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Document what's new moniker exception #3355

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions .github/copilot-instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

These notes capture our lightweight process and guardrails while submitting focused pull requests against `main` for .NET 10 changes.

Last updated: 2025-08-18
Last updated: 2026-05-24

## Branching and PRs

Expand All @@ -27,6 +27,8 @@ Last updated: 2025-08-18
- Use includes when appropriate to keep duplication low, but don’t over-abstract if a single page change is small and clear.- Typical include naming pattern: `*-dotnet9.md` / `*-dotnet10.md`.
- If behavior/API names change in .NET 10 but guidance is otherwise similar, keep <=9 and >=10 content parallel and explicit.
- Keep phrasing and headings consistent across monikered sections to minimize diffs.
- Don't wrap `docs/whats-new/dotnet-*.md` pages in same-version moniker blocks. These pages should render even when readers arrive with an older `view=` value from the version selector; use monikers in them only for content that truly differs by selected doc version.

## Preview drift and verification

Changes must be verified against the .NET MAUI source for .NET 10 to avoid preview drift:
Expand Down Expand Up @@ -95,4 +97,4 @@ To keep conceptual docs focused and avoid churn from low-impact API surface twea
## Maintenance

- Keep PRs small and focused; rebase/merge frequently to avoid conflicts.
- When conflicts arise in monikered pages, prioritize keeping both versioned includes accurate before deduplicating.
- When conflicts arise in monikered pages, prioritize keeping both versioned includes accurate before deduplicating.
Loading