Create / revise articles for classes, structs and records#52685
Merged
BillWagner merged 14 commits intodotnet:mainfrom Apr 3, 2026
Merged
Create / revise articles for classes, structs and records#52685BillWagner merged 14 commits intodotnet:mainfrom
BillWagner merged 14 commits intodotnet:mainfrom
Conversation
Create the new fundamentals article on struct types.
Reviewed classes.md, and about to embark on a large body of work for records.md
Reorder and make a number of content changes.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the C# fundamentals type-system content by revising the classes and records articles, adding a new structs article, and aligning the accompanying snippet projects/examples.
Changes:
- Add a new Structs fundamentals article and snippet project, and wire it into the C# TOC and type-system index.
- Revise Classes and Records fundamentals articles with updated structure, guidance, and refreshed snippets.
- Update snippet projects to target
net10.0and expand record snippets to include record-struct examples.
Reviewed changes
Copilot reviewed 16 out of 16 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/csharp/toc.yml | Adds the Structs article to the Type system section. |
| docs/csharp/fundamentals/types/index.md | Updates the Structs link to point to the new fundamentals article. |
| docs/csharp/fundamentals/types/classes.md | Rewrites the classes article and points to updated snippet IDs. |
| docs/csharp/fundamentals/types/records.md | Rewrites the records article and expands coverage (record structs, with, equality, inheritance). |
| docs/csharp/fundamentals/types/structs.md | Adds a new structs fundamentals article with referenced snippets. |
| docs/csharp/fundamentals/types/snippets/classes/classes.csproj | Updates snippet project target framework to net10.0. |
| docs/csharp/fundamentals/types/snippets/classes/Program.cs | Reworks class snippets (creation, reference semantics, required, initializers, inheritance). |
| docs/csharp/fundamentals/types/snippets/classes/Containers.cs | Renames namespaces and adds a pragma to avoid snippet warnings. |
| docs/csharp/fundamentals/types/snippets/records/Records.csproj | Updates snippet project target framework to net10.0. |
| docs/csharp/fundamentals/types/snippets/records/Program.cs | Adds invocation of the new record-struct demo entry point. |
| docs/csharp/fundamentals/types/snippets/records/RecordStruct.cs | Adds record struct declarations and demos (assignment semantics, with). |
| docs/csharp/fundamentals/types/snippets/records/FirstRecord.cs | Expands record snippets (declaration, body, inheritance, deconstruction). |
| docs/csharp/fundamentals/types/snippets/records/ImmutableRecord.cs | Updates with expression example. |
| docs/csharp/fundamentals/types/snippets/records/EqualityTest.cs | Updates equality example and narrative outputs. |
| docs/csharp/fundamentals/types/snippets/structs/structs.csproj | Adds a new structs snippet project targeting net10.0. |
| docs/csharp/fundamentals/types/snippets/structs/Program.cs | Adds structs examples for value semantics, constructors/default, readonly, and auto-default behavior. |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
gewarren
approved these changes
Apr 3, 2026
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
adegeo
reviewed
Apr 6, 2026
Contributor
adegeo
left a comment
adegeo
left a comment
There was a problem hiding this comment.
Ack, I didn't get to the structs article, but here were my comments in progress.
Comment on lines
+67
to
+69
| :::code language="csharp" source="snippets/records/ImmutableRecord.cs" ID="WithExpression"::: | ||
|
|
||
| The following example defines a public record that uses positional parameters to declare and instantiate a record. It then prints the type name and property values: | ||
| :::code language="csharp" source="snippets/records/RecordStruct.cs" ID="RecordStructWith"::: |
Contributor
There was a problem hiding this comment.
Same comment as the other back-to-back snippets. Get these into a single snippet.
Comment on lines
+55
to
+57
| :::code language="csharp" source="snippets/structs/Program.cs" ID="ReadonlyStruct"::: | ||
|
|
||
| :::code language="csharp" source="snippets/structs/Program.cs" ID="UsingReadonly"::: |
Contributor
There was a problem hiding this comment.
Same comment here, put something between these...
Comment on lines
+61
to
+63
| :::code language="csharp" source="snippets/structs/Program.cs" ID="ReadonlyMembers"::: | ||
|
|
||
| :::code language="csharp" source="snippets/structs/Program.cs" ID="UsingReadonlyMembers"::: |
Contributor
There was a problem hiding this comment.
Same comment here, put something between these...
BillWagner
added a commit
to BillWagner/docs
that referenced
this pull request
Apr 6, 2026
dotnet#52685 was merged while a review wasn't yet completed. Address those comments.
Merged
BillWagner
added a commit
that referenced
this pull request
Apr 7, 2026
* Address comments #52685 was merged while a review wasn't yet completed. Address those comments. * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * fix warning. * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>
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
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.
Fixes #51993
Revise the articles for the class, struct, and record types.
Internal previews