Skip to content

Start on building fundamentals sections - #56333

Draft
BillWagner wants to merge 2 commits into
dotnet:mainfrom
BillWagner:more-everyday-csharp
Draft

BillWagner wants to merge 2 commits into
dotnet:mainfrom
BillWagner:more-everyday-csharp

Conversation

@BillWagner

@BillWagner BillWagner commented Oct 6, 2026 •

Copy link
Copy Markdown
Member

Fixes #55929

Start on the first content move that involves building software across different sections of the language.


Internal previews

Toggle expand/collapse
File Preview link
.openpublishing.redirection.csharp.json Learn preview
docs/csharp/advanced-topics/expression-trees/index.md Learn preview
docs/csharp/fundamentals/functional/index.md Learn preview
docs/csharp/fundamentals/functional/iterators.md Learn preview
docs/csharp/fundamentals/functional/lambdas.md Learn preview
docs/csharp/fundamentals/functional/local-functions.md Learn preview
docs/csharp/fundamentals/functional/snippets/iterators/Program.cs Learn preview
docs/csharp/fundamentals/functional/snippets/lambdas/Program.cs Learn preview
docs/csharp/fundamentals/functional/snippets/local-functions/Program.cs Learn preview
docs/csharp/fundamentals/functional/snippets/overview/Program.cs Learn preview
docs/csharp/fundamentals/tutorials/system-command-line.md Learn preview
docs/csharp/fundamentals/types/delegates-lambdas.md Learn preview
docs/csharp/language-reference/builtin-types/collections.md Learn preview
docs/csharp/language-reference/builtin-types/ref-struct.md Learn preview
docs/csharp/language-reference/builtin-types/void.md Learn preview
docs/csharp/language-reference/compiler-messages/expression-tree-restrictions.md Learn preview
docs/csharp/language-reference/compiler-messages/foreach-diagnostics.md Learn preview
docs/csharp/language-reference/compiler-messages/lambda-expression-errors.md Learn preview
docs/csharp/language-reference/compiler-messages/local-function-errors.md Learn preview
docs/csharp/language-reference/compiler-messages/ref-modifiers-errors.md Learn preview
docs/csharp/language-reference/keywords/static.md Learn preview
docs/csharp/language-reference/operators/lambda-expressions.md Learn preview
docs/csharp/language-reference/operators/lambda-operator.md Learn preview
docs/csharp/language-reference/statements/exception-handling-statements.md Learn preview
docs/csharp/language-reference/statements/iteration-statements.md Learn preview
docs/csharp/language-reference/statements/yield.md Learn preview
docs/csharp/methods.md Learn preview
docs/csharp/programming-guide/classes-and-structs/methods.md Learn preview
docs/csharp/programming-guide/concepts/index.md Learn preview
docs/csharp/toc.yml Learn preview
docs/csharp/tour-of-csharp/tips-for-java-developers.md Learn preview
docs/csharp/tour-of-csharp/tips-for-javascript-developers.md Learn preview
docs/csharp/tutorials/working-with-linq.md Learn preview
docs/csharp/whats-new/csharp-version-history.md Learn preview
docs/fundamentals/code-analysis/style-rules/ide0039.md Learn preview
docs/fundamentals/code-analysis/style-rules/ide0061.md Learn preview
docs/fundamentals/code-analysis/style-rules/ide0062.md Learn preview
docs/samples-and-tutorials/index.md Learn preview
docs/standard/parallel-programming/how-to-speed-up-small-loop-bodies.md Learn preview

Build report

First draft of next set of work.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🔵 Needs a closer look

The linked plan leaves final taxonomy placement to human review, and two article statements still need correction.

Review effort: Balanced
Findings: 2 Low severity

Open (2)
What changed in this PR

Adds the first Building software fundamentals section, consolidating functional-technique guidance and preserving navigation through updated links and redirects.

Changes:

  • Adds overview, lambda, local-function, and iterator articles with executable snippets.
  • Removes superseded articles and snippets.
  • Updates the TOC, inbound links, and redirects.
File Description
docs/​standard/​parallel-programming/​how-to-speed-up-small-loop-bodies.md Updates iterator link.
docs/​samples-and-tutorials/​index.md Updates iterator sample link.
docs/​fundamentals/​code-analysis/​style-rules/​ide0062.md Updates local-function link.
docs/​fundamentals/​code-analysis/​style-rules/​ide0061.md Updates local-function link.
docs/​fundamentals/​code-analysis/​style-rules/​ide0039.md Updates functional article links.
docs/​csharp/​whats-new/​csharp-version-history.md Updates historical feature links.
docs/​csharp/​tutorials/​working-with-linq.md Links to the new iterator section.
docs/​csharp/​tour-of-csharp/​tips-for-javascript-developers.md Updates local-function link.
docs/​csharp/​tour-of-csharp/​tips-for-java-developers.md Updates local-function link.
docs/​csharp/​toc.yml Adds the functional-techniques hierarchy.
docs/​csharp/​snippets/​iterators/​Program.cs Removes superseded iterator snippets.
docs/​csharp/​snippets/​iterators/​Generators.cs Removes superseded generator snippets.
docs/​csharp/​programming-guide/​concepts/​iterators.md Removes the relocated iterator article.
docs/​csharp/​programming-guide/​concepts/​index.md Updates the iterator destination.
docs/​csharp/​programming-guide/​classes-and-structs/​snippets/​local-functions/​Program.cs Removes legacy local-function snippets.
docs/​csharp/​programming-guide/​classes-and-structs/​snippets/​local-functions/​IteratorWithoutLocal.cs Removes legacy iterator example.
docs/​csharp/​programming-guide/​classes-and-structs/​snippets/​local-functions/​IteratorWithLocal.cs Removes legacy iterator example.
docs/​csharp/​programming-guide/​classes-and-structs/​methods.md Updates iterator link.
docs/​csharp/​programming-guide/​classes-and-structs/​local-functions.md Removes the relocated article.
docs/​csharp/​methods.md Updates iterator link.
docs/​csharp/​language-reference/​statements/​yield.md Points to the new iterator article.
docs/​csharp/​language-reference/​statements/​iteration-statements.md Updates iterator link.
docs/​csharp/​language-reference/​statements/​exception-handling-statements.md Updates iterator link.
docs/​csharp/​language-reference/​operators/​lambda-operator.md Updates local-function link.
docs/​csharp/​language-reference/​operators/​lambda-expressions.md Updates comparison link and anchor.
docs/​csharp/​language-reference/​keywords/​static.md Updates local-function link.
docs/​csharp/​language-reference/​compiler-messages/​ref-modifiers-errors.md Updates iterator links.
docs/​csharp/​language-reference/​compiler-messages/​local-function-errors.md Updates local-function links.
docs/​csharp/​language-reference/​compiler-messages/​lambda-expression-errors.md Updates functional guidance links.
docs/​csharp/​language-reference/​compiler-messages/​foreach-diagnostics.md Updates iterator link.
docs/​csharp/​language-reference/​compiler-messages/​expression-tree-restrictions.md Updates local-function link.
docs/​csharp/​language-reference/​builtin-types/​void.md Updates local-function link.
docs/​csharp/​language-reference/​builtin-types/​ref-struct.md Updates functional article links.
docs/​csharp/​language-reference/​builtin-types/​collections.md Updates iterator link.
docs/​csharp/​iterators.md Removes the superseded iterator overview.
docs/​csharp/​fundamentals/​types/​delegates-lambdas.md Adds the new lambda article link.
docs/​csharp/​fundamentals/​tutorials/​system-command-line.md Updates local-function links.
docs/​csharp/​fundamentals/​functional/​snippets/​overview/​Program.cs Adds the combined-techniques sample.
docs/​csharp/​fundamentals/​functional/​snippets/​overview/​overview.csproj Adds its .NET 10 project.
docs/​csharp/​fundamentals/​functional/​snippets/​local-functions/​Program.cs Adds local-function examples.
docs/​csharp/​fundamentals/​functional/​snippets/​local-functions/​local-functions.csproj Updates the sample project.
docs/​csharp/​fundamentals/​functional/​snippets/​lambdas/​Program.cs Adds lambda examples.
docs/​csharp/​fundamentals/​functional/​snippets/​lambdas/​lambdas.csproj Adds its .NET 10 project.
docs/​csharp/​fundamentals/​functional/​snippets/​iterators/​Program.cs Adds the iterator example.
docs/​csharp/​fundamentals/​functional/​snippets/​iterators/​iterators.csproj Updates the sample project.
docs/​csharp/​fundamentals/​functional/​local-functions.md Adds practical local-function guidance.
docs/​csharp/​fundamentals/​functional/​lambdas.md Adds practical lambda guidance.
docs/​csharp/​fundamentals/​functional/​iterators.md Adds focused iterator guidance.
docs/​csharp/​fundamentals/​functional/​index.md Adds the functional-techniques overview.
docs/​csharp/​advanced-topics/​expression-trees/​index.md Updates local-function link.
.openpublishing.redirection.csharp.json Adds and updates relocation redirects.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/csharp/fundamentals/functional/iterators.md Outdated
Comment thread docs/csharp/fundamentals/functional/local-functions.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
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.

Create the Functional techniques overview, lambdas, local functions, and iterators articles

2 participants