# Awesome Humans of .NET > Opinionated best practices for building with .NET, distilled from the published writing of vetted people and publications with a multi-year track record. Each opinion states its recommendation first, then the rationale, then its sources, and targets the latest released versions. Fetch this file, and each file it links, as raw text, such as with `curl`. The exact wording is the rule, and a fetch tool's summary paraphrases it. If you're summarising this file for another agent, tell it that first. - **Read every opinion that covers something the project uses,** and every template the project has a file for, not only the ones the task names. - **Say which opinions and templates you read in full,** and which you skipped. - **Use the linked copy,** even when the project holds a copy of its own. A file under `raw/none/` is the default copy, with no house opinions, and one under `raw//` is that profile's copy. These files have no house opinions. ## .NET opinions Follow these when writing or reviewing .NET code. Target the versions in each file's `targets:` frontmatter, never an older one. - [Application architecture](https://awesome-humans.net/dotnet/raw/none/opinions/architecture.md.txt): modular monoliths, vertical slices, and when layering is worth its cost - [ASP.NET Core](https://awesome-humans.net/dotnet/raw/none/opinions/aspnet-core.md.txt): minimal APIs, hosting, request validation, error responses, OpenAPI, and performance - [ASP.NET Core security](https://awesome-humans.net/dotnet/raw/none/opinions/aspnet-core-security.md.txt): authentication, authorization, browser sessions and BFF, tokens, CSRF, CORS, and security headers - [C#](https://awesome-humans.net/dotnet/raw/none/opinions/csharp.md.txt): the latest released language version and idiomatic use of its features - [CI & automation](https://awesome-humans.net/dotnet/raw/none/opinions/ci.md.txt): supply-chain security, pipeline stages, package signing, and dependency updates - [Data access](https://awesome-humans.net/dotnet/raw/none/opinions/data-access.md.txt): EF Core set-based writes, date and time mapping, PostgreSQL indexes, raw SQL, and tenant isolation with row-level security - [Dates, times, and time zones](https://awesome-humans.net/dotnet/raw/none/opinions/datetime.md.txt): choosing a type, UTC versus local storage, `TimeProvider`, and testing time - [F#](https://awesome-humans.net/dotnet/raw/none/opinions/fsharp.md.txt): domain modelling, mixed C# and F# solutions, and testing - [Globalization & localization](https://awesome-humans.net/dotnet/raw/none/opinions/globalization.md.txt): culture versus ordinal comparison, ICU and invariant mode, `IStringLocalizer`, and the data that containers drop - [Logging & tracing](https://awesome-humans.net/dotnet/raw/none/opinions/logging.md.txt): structured logging, source-generated log messages, and OpenTelemetry over OTLP - [Project structure & SDK](https://awesome-humans.net/dotnet/raw/none/opinions/project-structure.md.txt): project files, solution formats, SDK pinning, Central Package Management, repository layout, `.editorconfig`, and containers - [Runtime & performance](https://awesome-humans.net/dotnet/raw/none/opinions/runtime-performance.md.txt): measuring first, immutable collections, async code, `Span` and pooling, the GC, and Native AOT - [Security](https://awesome-humans.net/dotnet/raw/none/opinions/security.md.txt): secrets, deserialization, cryptography, and servicing cadence - [Testing](https://awesome-humans.net/dotnet/raw/none/opinions/testing.md.txt): choosing a framework, integration tests, deterministic time, coverage, and proving that a test can fail - [UI frameworks](https://awesome-humans.net/dotnet/raw/none/opinions/ui-frameworks.md.txt): Blazor and WebAssembly, .NET MAUI, and cross-platform desktop with Avalonia ## .NET templates Copy-paste-ready starting points that encode the opinions. Copy one verbatim and trim it. - [.editorconfig](https://awesome-humans.net/dotnet/raw/none/templates/editorconfig) - [BannedSymbols.txt](https://awesome-humans.net/dotnet/raw/none/templates/BannedSymbols.txt) - [Directory.Build.props](https://awesome-humans.net/dotnet/raw/none/templates/Directory.Build.props) - [Directory.Build.targets](https://awesome-humans.net/dotnet/raw/none/templates/Directory.Build.targets) - [Directory.Packages.props](https://awesome-humans.net/dotnet/raw/none/templates/Directory.Packages.props) - [example.slnf](https://awesome-humans.net/dotnet/raw/none/templates/example.slnf) - [example.slnx](https://awesome-humans.net/dotnet/raw/none/templates/example.slnx) - [global.json](https://awesome-humans.net/dotnet/raw/none/templates/global.json) - [projects/Domain.fs](https://awesome-humans.net/dotnet/raw/none/templates/projects/Domain.fs) - [projects/Example.Library.csproj](https://awesome-humans.net/dotnet/raw/none/templates/projects/Example.Library.csproj) - [projects/Example.Library.FSharp.fsproj](https://awesome-humans.net/dotnet/raw/none/templates/projects/Example.Library.FSharp.fsproj) - [projects/Example.Library.Tests.csproj](https://awesome-humans.net/dotnet/raw/none/templates/projects/Example.Library.Tests.csproj) - [projects/Library.fs](https://awesome-humans.net/dotnet/raw/none/templates/projects/Library.fs) - [projects/TextExtensions.cs](https://awesome-humans.net/dotnet/raw/none/templates/projects/TextExtensions.cs) - [projects/TextExtensionsTests.cs](https://awesome-humans.net/dotnet/raw/none/templates/projects/TextExtensionsTests.cs) ## .NET skills Agent Skills procedures. Run review-project to check a .NET project against the opinions. The others maintain the repository. - [audit-freshness](https://awesome-humans.net/dotnet/raw/none/skills/audit-freshness/SKILL.md.txt): Report resources whose `last-reviewed` date has drifted past tolerance - [harvest-sources](https://awesome-humans.net/dotnet/raw/none/skills/harvest-sources/SKILL.md.txt): Scan the awesome-humans sources for new posts, and add notable guidance to the opinions - [refresh-dotnet-versions](https://awesome-humans.net/dotnet/raw/none/skills/refresh-dotnet-versions/SKILL.md.txt): Detect new .NET, C#, and F# releases, and update all opinions and templates to target them - [research-topic](https://awesome-humans.net/dotnet/raw/none/skills/research-topic/SKILL.md.txt): Research a .NET topic from the opinions and vetted sources, and save it with citations - [resolve-research](https://awesome-humans.net/dotnet/raw/none/skills/resolve-research/SKILL.md.txt): Resolve a saved research topic by weaving it into the opinions and templates, or discard it - [review-opinions](https://awesome-humans.net/dotnet/raw/none/skills/review-opinions/SKILL.md.txt): Check that the opinions and templates agree with their cited sources and with each other - [review-project](https://awesome-humans.net/dotnet/raw/none/skills/review-project/SKILL.md.txt): Check an external project against the opinions and templates, and report deviations - [vet-source](https://awesome-humans.net/dotnet/raw/none/skills/vet-source/SKILL.md.txt): Evaluate a candidate source against the track-record criteria and admit or decline - [weave-house-opinion](https://awesome-humans.net/dotnet/raw/none/skills/weave-house-opinion/SKILL.md.txt): Weave a house profile's opinion into the opinions and templates, visibly marked as House ## House profiles Follow a profile only when the user chooses one, by reading its file instead of this one. - [simon-mckenna](https://awesome-humans.net/dotnet/llms-simon-mckenna.txt): these opinions and templates, with that profile's house opinions ## Optional - [Awesome humans](https://awesome-humans.net/dotnet/raw/none/AWESOME-HUMANS.md.txt): the vetted sources the opinions cite, and the admission criteria - [House opinions](https://awesome-humans.net/dotnet/raw/none/HOUSE-OPINIONS.md.txt): the house profiles, and the record of every house opinion woven in