Skip to content

Add include to help readers find the initial version#51041

Merged
BillWagner merged 6 commits intodotnet:mainfrom
BillWagner:first-version-notes
Jan 15, 2026
Merged

Add include to help readers find the initial version#51041
BillWagner merged 6 commits intodotnet:mainfrom
BillWagner:first-version-notes

Conversation

@BillWagner
Copy link
Member

@BillWagner BillWagner commented Jan 13, 2026

Fixes #50891

Commit-by-commit:

  • Create include file
  • Add include to the articles in the attributes folder.
  • Add include to the articles in the builtin-types folder.
  • Add include to the articles in the tokens folder.

Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/csharp/language-reference/attributes/caller-information.md Determine caller information by using attributes that the C# compiler interprets
docs/csharp/language-reference/attributes/general.md "Attributes interpreted by the compiler: Miscellaneous"
docs/csharp/language-reference/attributes/global.md Assembly level attributes interpreted by the C# compiler
docs/csharp/language-reference/attributes/nullable-analysis.md docs/csharp/language-reference/attributes/nullable-analysis
docs/csharp/language-reference/attributes/pseudo-attributes.md Custom attributes that generate flags or options in the Intermediate Language (IL) output
docs/csharp/language-reference/builtin-types/arrays.md Arrays
docs/csharp/language-reference/builtin-types/bool.md "bool type"
docs/csharp/language-reference/builtin-types/built-in-types.md Built-in types (C# reference)
docs/csharp/language-reference/builtin-types/char.md docs/csharp/language-reference/builtin-types/char
docs/csharp/language-reference/builtin-types/collections.md Collections
docs/csharp/language-reference/builtin-types/default-values.md "Default values of built-in types"
docs/csharp/language-reference/builtin-types/enum.md Enumeration types (C# reference)
docs/csharp/language-reference/builtin-types/floating-point-numeric-types.md Floating-point numeric types (C# reference)
docs/csharp/language-reference/builtin-types/integral-numeric-types.md Integral numeric types (C# reference)
docs/csharp/language-reference/builtin-types/nullable-reference-types.md docs/csharp/language-reference/builtin-types/nullable-reference-types
docs/csharp/language-reference/builtin-types/nullable-value-types.md Nullable value types (C# reference)
docs/csharp/language-reference/builtin-types/numeric-conversions.md Built-in numeric conversions (C# reference)
docs/csharp/language-reference/builtin-types/ref-struct.md "ref struct types"
docs/csharp/language-reference/builtin-types/reference-types.md Built-in reference types (C# reference)
docs/csharp/language-reference/builtin-types/struct.md docs/csharp/language-reference/builtin-types/struct
docs/csharp/language-reference/builtin-types/unmanaged-types.md Unmanaged types (C# reference)
docs/csharp/language-reference/builtin-types/value-tuples.md Tuple types (C# reference)
docs/csharp/language-reference/builtin-types/value-types.md "Value types"
docs/csharp/language-reference/builtin-types/void.md void (C# reference)
docs/csharp/language-reference/tokens/comments.md docs/csharp/language-reference/tokens/comments
docs/csharp/language-reference/tokens/discard.md Discard - A _ acts as a placeholder for a variable
docs/csharp/language-reference/tokens/index.md C# special characters
docs/csharp/language-reference/tokens/interpolated.md String interpolation using $
docs/csharp/language-reference/tokens/raw-string.md "Raw string literals - """"
docs/csharp/language-reference/tokens/verbatim.md Verbatim text - @ in variables, attributes, and string literals

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

We get repeated comments to describe when a feature was added to the language. We're not doing that for every feature. However, we can link to the version history article to help readers find the first version for a given feature.
Also, perform a general edit pass.
Also, run an edit and freshness pass.
Add the include file in the tokens folder. Perform a general edit and freshness pass.
@BillWagner
Copy link
Member Author

Other folders will be added in later PRs.

@BillWagner BillWagner marked this pull request as ready for review January 14, 2026 22:00
@BillWagner BillWagner requested a review from a team as a code owner January 14, 2026 22:00
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a reusable include file that helps readers find when C# features were first introduced. The include is added to 33 documentation files across the attributes, builtin-types, and tokens folders to provide consistent information about C# language version history.

Changes:

  • Created a new include file (initial-version.md) explaining how to find feature introduction versions
  • Added the include to all files in the attributes, builtin-types, and tokens folders
  • Updated dates to 01/14/2026 across all modified files
  • Made minor text improvements for clarity and consistency with documentation guidelines

Reviewed changes

Copilot reviewed 32 out of 32 changed files in this pull request and generated 5 comments.

File Description
docs/csharp/language-reference/includes/initial-version.md New include file directing readers to C# version history
docs/csharp/language-reference/attributes/*.md (5 files) Added include and updated dates
docs/csharp/language-reference/builtin-types/*.md (20 files) Added include, updated dates, minor text improvements
docs/csharp/language-reference/tokens/*.md (7 files) Added include, updated dates, code snippet syntax updates

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

@meaghanlewis meaghanlewis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Just a handful of minor suggestions.

Co-authored-by: Meaghan Osagie (Lewis) <moneikmarie@gmail.com>
@BillWagner BillWagner enabled auto-merge (squash) January 15, 2026 18:42
@BillWagner BillWagner merged commit 4b9c767 into dotnet:main Jan 15, 2026
9 checks passed
@BillWagner BillWagner deleted the first-version-notes branch January 15, 2026 19:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add prominent links to the Version history page.

3 participants