templates-dotnet/.github/instructions/csharp.instructions.md

description, applyTo

description	applyTo
Use when writing or modifying C# source code. Covers non-obvious defaults not caught by analyzers.	**/*.cs

C# Conventions

Code style is enforced by .editorconfig, .globalconfig, and StyleCop analyzers — do not restate their rules.

Non-Obvious Defaults

• XML doc comments required on all public and protected members in src/ (suppressed in tests/ and samples/).
• Avoid null! (null-forgiving operator) — fix the nullability flow instead of suppressing the warning.

Patterns

• Prefer records for DTOs, value objects, and other immutable data carriers.
• Use LoggerMessage-generated partial methods on a partial class — never log inline (e.g., logger.LogInformation(…)). If the containing type cannot be made partial, convert it to a partial class before adding logger methods. Do not fall back to inline logging.