Minecraft-Console-Client/.skills/csharp-dotnet-cli-optimization/references/README.md

description	metadata
Dated source ledger for csharp-dotnet-cli-optimization.	tags sources diagnostics gc linq span stackalloc boxing

Sources

Current primary sources

• dotnet-counters, Microsoft Learn, updated 2025-10-02
  • Canonical CLI docs for live counters, monitor, collect, and dnx one-shot execution on .NET 10.0.100+.
• dotnet-trace, Microsoft Learn, updated 2026-03-20
  • Canonical CLI docs for collect, report, and the preview collect-linux path plus its limits.
• dotnet-dump, Microsoft Learn, updated 2026-03-04
  • Canonical CLI docs for dump collection, dump types, and analyze -c.
• dotnet-gcdump, Microsoft Learn, updated 2025-12-17
  • Canonical CLI docs for GC dump collection, report, and the induced full Gen 2 GC caveat.
• Fundamentals of garbage collection, Microsoft Learn, updated 2025-10-22
  • Current official overview of generations, allocation, and managed heap behavior.
• Runtime configuration options for garbage collection, Microsoft Learn, updated 2025-11-22
  • Current official source for server vs workstation GC, background GC, heap limits, LOH threshold, and modern GC configuration behavior.
• stackalloc expression, Microsoft Learn, updated 2026-01-24
  • Current official guidance for stack allocation limits, loop avoidance, initialization, and Span-based usage.
• ref struct types, Microsoft Learn, updated 2026-01-20
  • Current official guidance for stack-only semantics and escape restrictions.
• Structure types, Microsoft Learn, updated 2026-01-14
  • Current official source for readonly structs, pass-by-reference guidance, and boxing conversions.
• Value types, Microsoft Learn, updated 2026-01-20
  • Current official source for copy semantics and inline storage behavior.
• Boxing and Unboxing, Microsoft Learn, updated 2025-10-13
  • Current official source for boxing semantics and cost.
• Memory and Span usage guidelines, Microsoft Learn, updated 2025-04-11
  • Current official guidance for choosing Span<T> vs Memory<T> and ownership rules.
• Lambda expressions, Microsoft Learn, updated 2026-01-24
  • Current official source for capture semantics and static lambdas.
• What's new in C# 14, Microsoft Learn, updated 2025-11-19
  • Current official confirmation of first-class span conversions in C# 14.
• Performance rules, Microsoft Learn, updated 2025-10-29
  • Current official index of analyzer-backed performance rules, including CA1870.
• Performance Improvements in .NET 10, Stephen Toub, published 2025-09-10
  • High-trust expert source showing real .NET 10 runtime and LINQ improvements. Use it to avoid stale folklore such as "all LINQ is slow".

Specific analyzer pages used for code-pattern guidance

• CA1827, updated 2023-11-14
• CA1845, updated 2024-11-12
• CA1846, updated 2023-12-16
• CA1851, updated 2023-11-14
• CA1858, current official analyzer page
• CA1860, current official analyzer page

Older but still canonical sources used cautiously

• Reduce memory allocations using new C# features, Microsoft Learn, updated 2023-10-17
  • Still useful for ref, in, readonly struct, and copy-avoidance guidance, but older than the core 2025-2026 docs.
• Intermediate materialization, Microsoft Learn, updated 2022-09-02
  • Still canonical for LINQ materialization semantics.
• Deferred execution and lazy evaluation, Microsoft Learn, updated 2022-09-29
  • Still canonical for LINQ deferred-execution semantics.
• dotnet-stack, Microsoft Learn, updated 2023-03-14
  • Used only for narrow stack-snapshot guidance because the page is stale compared to the other diagnostics docs.

Explicit exclusions

• Framework-specific tutorials were intentionally excluded.
• GUI-first analysis flows were intentionally excluded.
• MCC-specific paths, code, and hot-path examples were intentionally excluded.