Tuples interfaces generics by BillWagner · Pull Request #52891 · dotnet/docs

BillWagner · 2026-04-07T20:08:54Z

Fixes #51994

Replace anonymous-types.md with a dedicated tuples.md focused on tuples and deconstruction. Revise interfaces.md to trim advanced content (default interface members, static abstract members). Revise generics.md to shift from authoring to consuming generics and add collection expressions, dictionary expressions, spread, and co-/contra-variance. Update snippets, toc.yml, and redirects.

Internal previews

Toggle expand/collapse

📄 File	🔗 Preview link
docs/core/diagnostics/diagnosticsource-diagnosticlistener.md	DiagnosticSource and DiagnosticListener
docs/csharp/fundamentals/object-oriented/index.md	Overview of object oriented techniques in C#
docs/csharp/fundamentals/types/enums.md	"C# Enumerations"
docs/csharp/fundamentals/types/generics.md	Generic types and methods
docs/csharp/fundamentals/types/interfaces.md	docs/csharp/fundamentals/types/interfaces
docs/csharp/fundamentals/types/tuples.md	Tuples and deconstruction
docs/csharp/language-reference/builtin-types/value-tuples.md	"Tuple types"
docs/csharp/language-reference/keywords/select-clause.md	select clause (C# Reference)
docs/csharp/language-reference/operators/new-operator.md	new operator - The `new` operator creates a new instance of a type
docs/csharp/language-reference/operators/with-expression.md	docs/csharp/language-reference/operators/with-expression
docs/csharp/language-reference/statements/declarations.md	Declaration statements
docs/csharp/linq/get-started/features-that-support-linq.md	"Language features that support LINQ"
docs/csharp/linq/standard-query-operators/index.md	Standard query operators overview
docs/csharp/linq/standard-query-operators/join-operations.md	docs/csharp/linq/standard-query-operators/join-operations
docs/csharp/misc/cs0746.md	Compiler Error CS0746
docs/csharp/misc/cs0833.md	"Compiler Error CS0833"
docs/csharp/programming-guide/classes-and-structs/access-modifiers.md	Access modifiers (C# programming guide)
docs/csharp/programming-guide/classes-and-structs/anonymous-types.md	docs/csharp/programming-guide/classes-and-structs/anonymous-types
docs/csharp/programming-guide/classes-and-structs/how-to-return-subsets-of-element-properties-in-a-query.md	How to return subsets of element properties in a query (C# Programming Guide)
docs/csharp/programming-guide/classes-and-structs/how-to-use-implicitly-typed-local-variables-and-arrays-in-a-query-expression.md	"How to use implicitly typed local variables and arrays in a query expression"
docs/csharp/programming-guide/classes-and-structs/implicitly-typed-local-variables.md	Implicitly typed local variables (C# Programming Guide)
docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers.md	docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers
docs/csharp/toc.yml	Taken from https://github.com/dotnet/roslyn/wiki/Samples-and-Walkthroughs
docs/csharp/whats-new/csharp-version-history.md	The history of C#
docs/fsharp/language-reference/anonymous-records.md	Anonymous Records
docs/fundamentals/code-analysis/style-rules/ide0037.md	Use inferred member names (IDE0037)
docs/fundamentals/code-analysis/style-rules/ide0050.md	docs/fundamentals/code-analysis/style-rules/ide0050
docs/standard/base-types/choosing-between-anonymous-and-tuple.md	Choosing between anonymous and tuple types
docs/standard/linq/concepts-terminology-functional-transformation.md	Concepts and terminology (functional transformation) - LINQ to XML
docs/standard/linq/project-anonymous-type.md	How to project an anonymous type (LINQ to XML)

1. **Create `fundamentals/types/tuples.md`** — New "Tuples and deconstruction" article replacing `anonymous-types.md` - Content: tier tip, tuple declaration with named elements, inferred element names (C# 7.1), tuples as return types, tuple deconstruction (tuple-specific parts merged from `deconstruct.md`), discards (brief, link to `discards.md`), tuple comparison `==`/`!=` (C# 7.3), `with` on tuples, brief "prefer tuples over anonymous types" note linking to language reference - Does NOT duplicate: full syntax reference (stays in `value-tuples.md`), user-defined `Deconstruct`/extension methods (stays in `deconstruct.md`) - Frontmatter: `ms.topic: concept`, `ai-usage: ai-assisted`, no `f1_keywords`/`helpviewer_keywords` 1. **Create `snippets/tuples/` directory** — `tuples.csproj` (net10.0) + `Program.cs` with all snippet regions. Uses Everyday C# features. *parallel with step 1* 1. **Delete `anonymous-types.md`** and **`snippets/anonymous-types/`** — replaced by tuples. *depends on steps 1–2*

1. **Revise `interfaces.md`** — Remove `helpviewer_keywords`, add `ms.topic: concept` + `ai-usage: ai-assisted` + tier tip. Keep: declaring, implementing (implicit/explicit), interface inheritance, internal interfaces. Trim: default interface members → link to advanced; static abstract → brief mention linking out. Update summary bullets. 1. **Update `snippets/interfaces/`** — `.csproj` to net10.0, modernize `interfaces.cs` with latest features. *depends on step 4*

1. **Revise `generics.md`** — Remove `f1_keywords`/`helpviewer_keywords`, add `ms.topic: concept` + `ai-usage: ai-assisted` + tier tip. Reframe around **consuming** generics (`List<T>`, `Dictionary<TKey,TValue>`, `Task<T>`, `Func<T,TResult>`). Add: type inference, basic constraints (`class`/`struct`/`new()`/base type, brief `Enum`/`Delegate`/`unmanaged`), collection expressions (C# 12) with spread `..`, dictionary expressions (C# 14), co-/contra-variance at consumption level (link to `covariance-contravariance/` for depth). Demote `GenericList<T>` authoring example to secondary. 1. **Update `snippets/generics/`** — `.csproj` to net10.0, rewrite `Program.cs` with consuming-focused examples. *depends on step 6*

1. **Update `docs/csharp/toc.yml`** — Change "Tuples and anonymous types" → "Tuples and deconstruction" pointing to `tuples.md`. Remove `# TODO: tuples` comment. 1. **Update `.openpublishing.redirection.csharp.json`** — Modify existing redirect (`programming-guide/.../anonymous-types.md` → `/dotnet/csharp/fundamentals/types/tuples`). Add new redirect (`fundamentals/types/anonymous-types.md` → `/dotnet/csharp/fundamentals/types/tuples`). Sort alphabetically. 1. **Update cross-references** — Fix links to `anonymous-types.md` in `csharp-version-history.md` and `value-tuples.md` to point to `tuples.md` or language reference.

Replace links to the old anonymous types article.

Copilot

Pull request overview

This PR restructures Everyday C# “type system” documentation by introducing a dedicated tuples article, refocusing interfaces and generics articles for fundamentals readers, and updating cross-references, snippets, TOC, and redirects.

Changes:

Replaces the former anonymous-types.md fundamentals article with a new tuples.md focused on tuples and deconstruction, and updates redirects/TOC.
Revises interfaces.md and generics.md to emphasize common usage patterns, with refreshed snippets.
Updates many docs to repoint anonymous-types references, plus related redirects.

Reviewed changes

Copilot reviewed 37 out of 37 changed files in this pull request and generated 30 comments.

Show a summary per file

File	Description
docs/standard/linq/project-anonymous-type.md	Updates “Anonymous Types” links to the new fundamentals target.
docs/standard/linq/concepts-terminology-functional-transformation.md	Updates anonymous-types reference link in terminology.
docs/standard/base-types/choosing-between-anonymous-and-tuple.md	Updates references to fundamentals anonymous-types page.
docs/fundamentals/code-analysis/style-rules/ide0050.md	Updates anonymous-types links referenced by the analyzer rule.
docs/fundamentals/code-analysis/style-rules/ide0037.md	Updates anonymous-types link in analyzer rule overview.
docs/fsharp/language-reference/anonymous-records.md	Updates link for C# anonymous types interop section.
docs/csharp/whats-new/csharp-version-history.md	Updates “Anonymous types” link in C# 3.0 feature list.
docs/csharp/toc.yml	Replaces the “Tuples and anonymous types” TOC entry with “Tuples and deconstruction”.
docs/csharp/programming-guide/classes-and-structs/object-and-collection-initializers.md	Updates link target for anonymous types reference.
docs/csharp/programming-guide/classes-and-structs/implicitly-typed-local-variables.md	Updates anonymous types links to new fundamentals target.
docs/csharp/programming-guide/classes-and-structs/how-to-use-implicitly-typed-local-variables-and-arrays-in-a-query-expression.md	Updates anonymous types reference link.
docs/csharp/programming-guide/classes-and-structs/how-to-return-subsets-of-element-properties-in-a-query.md	Updates “Anonymous Types” link in “See also”.
docs/csharp/programming-guide/classes-and-structs/access-modifiers.md	Updates “Anonymous types” link in “See also”.
docs/csharp/misc/cs0833.md	Updates “Anonymous Types” link in “See also”.
docs/csharp/misc/cs0746.md	Updates “Anonymous Types” link in “See also”.
docs/csharp/linq/standard-query-operators/join-operations.md	Updates “Anonymous types” link in “See also”.
docs/csharp/linq/standard-query-operators/index.md	Updates “Anonymous Types” link in “See also”.
docs/csharp/linq/get-started/features-that-support-linq.md	Updates “anonymous type” link in the anonymous types section.
docs/csharp/language-reference/statements/declarations.md	Updates anonymous types link in implicitly-typed locals discussion.
docs/csharp/language-reference/operators/with-expression.md	Updates anonymous types link in operand description.
docs/csharp/language-reference/operators/new-operator.md	Updates anonymous types link in “Instantiation of anonymous types”.
docs/csharp/language-reference/keywords/select-clause.md	Updates “Anonymous Types” link in “See also”.
docs/csharp/language-reference/builtin-types/value-tuples.md	Removes link to removed anonymous-types fundamentals page.
docs/csharp/fundamentals/types/tuples.md	Adds new fundamentals article for tuples and deconstruction.
docs/csharp/fundamentals/types/snippets/tuples/tuples.csproj	Retargets tuples snippet project to `net10.0`.
docs/csharp/fundamentals/types/snippets/tuples/Program.cs	Adds new tuples/deconstruction/equality/with/dictionary examples.
docs/csharp/fundamentals/types/snippets/interfaces/interfaces.csproj	Retargets interfaces snippet project to `net10.0`.
docs/csharp/fundamentals/types/snippets/interfaces/interfaces.cs	Reworks interface examples (implicit/explicit impl, inheritance, internal interfaces).
docs/csharp/fundamentals/types/interfaces.md	Rewrites the interfaces fundamentals article and references new snippets.
docs/csharp/fundamentals/types/snippets/generics/Program.cs	Reworks generics samples toward “consuming generics” and newer syntax examples.
docs/csharp/fundamentals/types/snippets/generics/generics.csproj	Retargets generics snippet project to `net10.0` and removes explicit startup object.
docs/csharp/fundamentals/types/snippets/anonymous-types/Program.cs	Removes old anonymous-types snippet program (file deleted).
docs/csharp/fundamentals/types/generics.md	Rewrites generics fundamentals article and references new snippets.
docs/csharp/fundamentals/types/anonymous-types.md	Removes old fundamentals anonymous types article (file deleted).
docs/csharp/fundamentals/object-oriented/index.md	Updates anonymous types section to point to tuples article.
docs/core/diagnostics/diagnosticsource-diagnosticlistener.md	Updates anonymous-type link in DiagnosticSource payload guidance.
.openpublishing.redirection.csharp.json	Adds/updates redirects from removed anonymous-types pages to the new tuples page.

Comments suppressed due to low confidence (1)

docs/csharp/misc/cs0833.md:42

The “Anonymous Types” reference now links to fundamentals/types/tuples.md, but this compiler error is specifically about anonymous types. Link to anonymous-type documentation (or add an anchor/section in the destination) so the reference matches the error topic.

## See also

- [Anonymous Types](../fundamentals/types/tuples.md)

docs/csharp/fundamentals/types/snippets/interfaces/interfaces.cs

docs/csharp/fundamentals/types/interfaces.md

docs/standard/linq/project-anonymous-type.md

docs/csharp/language-reference/operators/with-expression.md

docs/csharp/language-reference/operators/new-operator.md

docs/csharp/language-reference/keywords/select-clause.md

docs/core/diagnostics/diagnosticsource-diagnosticlistener.md

docs/csharp/fundamentals/types/snippets/tuples/Program.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…agner/docs into tuples-interfaces-generics

Recreate the anonymous types article in the programming guide section.

Update links to the new anonymous types article, or both the tuples and anonymous types article.

BillWagner · 2026-04-10T15:30:29Z

@adegeo This is ready for final review.

docs/csharp/fundamentals/types/generics.md

docs/csharp/fundamentals/types/interfaces.md

plan-fix-anonymous-types-links.md

docs/csharp/programming-guide/classes-and-structs/anonymous-types.md

docs/csharp/language-reference/operators/with-expression.md

.openpublishing.redirection.csharp.json

docs/csharp/fundamentals/types/tuples.md

docs/standard/base-types/choosing-between-anonymous-and-tuple.md

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

BillWagner added 4 commits April 7, 2026 15:39

dotnetrepoman bot added this to the April 2026 milestone Apr 7, 2026

dotnet-policy-service bot added dotnet-csharp/svc fundamentals/subsvc whats-new/subsvc lang-reference/subsvc labels Apr 7, 2026

BillWagner added 2 commits April 7, 2026 16:29

fix build warning

f128767

fix links

6e4216e

Replace links to the old anonymous types article.

dotnet-policy-service bot added dotnet-fundamentals/svc csharp-errors-warnings/subsvc csharp-linq/subsvc dotnet-fsharp/svc labels Apr 7, 2026

Proofread and content review

22a5599

BillWagner marked this pull request as ready for review April 9, 2026 21:37

BillWagner requested review from a team, adegeo, gewarren and tommcdon as code owners April 9, 2026 21:37

Copilot AI review requested due to automatic review settings April 9, 2026 21:37

Copilot started reviewing on behalf of BillWagner April 9, 2026 21:37 View session

Copilot AI reviewed Apr 9, 2026

View reviewed changes

BillWagner and others added 5 commits April 10, 2026 10:24

Apply suggestions from code review

3ec417f

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Merge branch 'tuples-interfaces-generics' of https://github.com/BillW…

ffcc889

…agner/docs into tuples-interfaces-generics

Recreate anonymous types article

7fd4661

Recreate the anonymous types article in the programming guide section.

Update relevant links

37c1c12

Update links to the new anonymous types article, or both the tuples and anonymous types article.

Proofread new article.

a3da79d

gewarren approved these changes Apr 10, 2026

View reviewed changes

BillWagner and others added 2 commits April 10, 2026 14:38

Apply suggestions from code review

cb72b68

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

Respond to feedback.

69a2eca

BillWagner merged commit e5e0f3e into dotnet:main Apr 10, 2026
9 checks passed

BillWagner deleted the tuples-interfaces-generics branch April 10, 2026 18:54

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Tuples interfaces generics#52891

Tuples interfaces generics#52891
BillWagner merged 14 commits intodotnet:mainfrom
BillWagner:tuples-interfaces-generics

BillWagner commented Apr 7, 2026 •

edited by github-actions bot

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BillWagner commented Apr 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

BillWagner commented Apr 7, 2026 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Internal previews

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BillWagner commented Apr 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

BillWagner commented Apr 7, 2026 •

edited by github-actions bot

Loading