Skip to content

Publish the version 11 alpha draft#53843

Open
BillWagner wants to merge 2 commits into
dotnet:mainfrom
BillWagner:publish-v11
Open

Publish the version 11 alpha draft#53843
BillWagner wants to merge 2 commits into
dotnet:mainfrom
BillWagner:publish-v11

Conversation

@BillWagner
Copy link
Copy Markdown
Member

@BillWagner BillWagner commented May 13, 2026

Fixes #53551

Use the repository prompt to update the docset to use the alpha 11 branch rather than the alpha 10 branch.

Major changes are in the docfx.json and the spec overview page.


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/csharp/language-reference/attributes/general.md Miscellaneous attributes interpreted by the C# compiler
docs/csharp/language-reference/builtin-types/default-values.md "Default values of built-in types"
docs/csharp/language-reference/builtin-types/integral-numeric-types.md Integral numeric types (C# reference)
docs/csharp/language-reference/builtin-types/ref-struct.md docs/csharp/language-reference/builtin-types/ref-struct
docs/csharp/language-reference/builtin-types/reference-types.md Built-in reference types (C# reference)
docs/csharp/language-reference/builtin-types/struct.md "Structure types"
docs/csharp/language-reference/compiler-messages/overloaded-operator-errors.md Resolve errors and warnings for operator declarations and overflow
docs/csharp/language-reference/compiler-messages/parameter-argument-mismatch.md docs/csharp/language-reference/compiler-messages/parameter-argument-mismatch
docs/csharp/language-reference/compiler-messages/ref-modifiers-errors.md Errors and warnings associated with reference parameters, variables, and returns
docs/csharp/language-reference/compiler-messages/string-interpolations.md Resolve errors and warnings for string interpolation expressions
docs/csharp/language-reference/keywords/file.md The file modifier
docs/csharp/language-reference/keywords/interface.md :::no-loc text="interface"::: (C# Reference)
docs/csharp/language-reference/keywords/required.md docs/csharp/language-reference/keywords/required
docs/csharp/language-reference/operators/bitwise-and-shift-operators.md Bitwise and shift operators (C# reference)
docs/csharp/language-reference/operators/nameof.md "The nameof expression - evaluate the text name of a symbol"
docs/csharp/language-reference/operators/patterns.md Pattern matching - the is and switch expressions, and operators and, or, and not in patterns
docs/csharp/language-reference/statements/checked-and-unchecked.md docs/csharp/language-reference/statements/checked-and-unchecked
docs/csharp/language-reference/statements/declarations.md Declaration statements
docs/csharp/language-reference/tokens/interpolated.md "$ - string interpolation - format string output"
docs/csharp/language-reference/tokens/raw-string.md Raw string literal text - """ in string literals
docs/csharp/programming-guide/classes-and-structs/static-constructors.md docs/csharp/programming-guide/classes-and-structs/static-constructors
docs/csharp/specification/overview.md C# standard specification
docs/csharp/specification/toc.yml docs/csharp/specification/toc
docs/csharp/whats-new/csharp-version-history.md The history of C#
docs/standard/unsafe-code/best-practices.md Unsafe code best practices - .NET

Fixes dotnet#53551

Use the repository prompt to update the docset to use the alpha 11 branch rather than the alpha 10 branch.

Major changes are in the docfx.json and the spec overview page.
Copy link
Copy Markdown
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 updates the C# specification docset to publish the C# v11 alpha draft by switching the dependent csharpstandard repository branch and updating site navigation and in-article references to point at the language specification (instead of older C# 11 feature proposal notes).

Changes:

  • Switch the _csharpstandard dependent repository branch from alpha-v10 to v11-alpha for publishing.
  • Update the C# specification overview and TOC to reference the C# 11 early draft and remove C# 11 proposal-note entries from the spec TOC.
  • Replace many references to C# 11 proposal documents with links into the C# language specification sections.

Reviewed changes

Copilot reviewed 28 out of 28 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/standard/unsafe-code/best-practices.md Updates guidance link to point at the spec “safe context constraint” section.
docs/csharp/whats-new/csharp-version-history.md Fixes the module initializer spec section anchor reference.
docs/csharp/specification/toc.yml Renames the early draft to C# 11 and removes C# 11 proposal-note entries from the spec TOC.
docs/csharp/specification/overview.md Updates ms.date and changes overview text to “C# 11” early draft.
docs/csharp/programming-guide/classes-and-structs/static-constructors.md Updates module initializer spec anchor reference.
docs/csharp/language-reference/tokens/raw-string.md Replaces proposal-note link with a language spec “string literals” link.
docs/csharp/language-reference/tokens/interpolated.md Updates spec anchor reference and consolidates raw string guidance to spec.
docs/csharp/language-reference/statements/declarations.md Replaces proposal-note link for scoped with the spec section link.
docs/csharp/language-reference/statements/checked-and-unchecked.md Replaces proposal-note link with a spec “operators” link.
docs/csharp/language-reference/operators/patterns.md Replaces list-pattern proposal-note link with spec section links.
docs/csharp/language-reference/operators/nameof.md Removes proposal-note link, leaving spec link only.
docs/csharp/language-reference/operators/bitwise-and-shift-operators.md Removes C# 11 proposal-note links from the spec references list.
docs/csharp/language-reference/keywords/required.md Replaces proposal-note link with spec links for required members.
docs/csharp/language-reference/keywords/interface.md Replaces proposal-note link with spec links for interface operators and static constructors.
docs/csharp/language-reference/keywords/file.md Removes proposal-note link, leaving spec link only.
docs/csharp/language-reference/compiler-messages/string-interpolations.md Updates spec anchor reference for interpolated string handlers.
docs/csharp/language-reference/compiler-messages/ref-modifiers-errors.md Replaces proposal-note link with spec link for safe context constraint.
docs/csharp/language-reference/compiler-messages/parameter-argument-mismatch.md Updates spec anchor reference for interpolated string handlers.
docs/csharp/language-reference/compiler-messages/overloaded-operator-errors.md Replaces proposal-note link with spec “operators” link.
docs/csharp/language-reference/builtin-types/struct.md Replaces proposal-note link with a spec section link for auto-default struct behavior.
docs/csharp/language-reference/builtin-types/reference-types.md Replaces proposal-note links with spec “string literals” link.
docs/csharp/language-reference/builtin-types/ref-struct.md Replaces proposal-note link with spec section link for ref fields.
docs/csharp/language-reference/builtin-types/integral-numeric-types.md Removes the numeric IntPtr proposal-note link from spec references list.
docs/csharp/language-reference/builtin-types/default-values.md Replaces proposal-note link with a spec section link for auto-default struct behavior.
docs/csharp/language-reference/attributes/general.md Updates spec anchor reference for interpolated string handlers.
docfx.json Removes C# 11 proposal content/metadata from build configuration.
.openpublishing.redirection.csharp.json Updates redirects to point at language specification sections instead of proposal pages.
.openpublishing.publish.config.json Switches the _csharpstandard dependency branch to v11-alpha.
Comments suppressed due to low confidence (1)

docfx.json:55

  • The build config no longer includes _csharplang/proposals/csharp-11.0/*.md under csharp/language-reference/proposals. If these C# 11 proposal pages have been published previously, removing them will create 404s for inbound links (deep links to individual proposals, not just the index.md). Add explicit redirects for the removed csharp-11.0 proposal pages (or keep publishing them as redirect stubs) so existing URLs continue to resolve.
                "files": [
                    "csharp-12.0/*.md",
                    "csharp-13.0/*.md",
                    "csharp-14.0/*.md",
                    "collection-expression-arguments.md",

One anchor moved.
@BillWagner BillWagner marked this pull request as ready for review May 13, 2026 18:02
@BillWagner BillWagner requested review from a team and gewarren as code owners May 13, 2026 18:03
@BillWagner BillWagner closed this May 13, 2026
@BillWagner BillWagner reopened this May 13, 2026
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.

Publish the alpha branch of C# v11

2 participants