Coding Standard

C# Code

Baseline

This project follows the common C# coding conventions and C# identifier naming rules and conventions.

Enforcement

The coding standard is enforced using a combination of two tools:

• The standard .editorconfig, which is configured to generate warnings during builds. All warnings must be resolved before submitting a pull request (PR).
• JetBrains’ code style settings, which provide more comprehensive rules than .editorconfig. These settings are not enforced for every PR.

Automatic Formatting

For day-to-day development, you can use the code formatting feature of your IDE. Both Visual Studio’s and Rider’s code cleanup tools are supported.

Quality Criteria for Releases

Certain quality criteria are not covered by build warnings and are enforced manually before each release.

Prior to every release, we perform a complete code cleanup using the following script:

Build.ps1 codestyle format

Do not reformat files that you have not directly modified in your PR.

Additionally, we run the full JetBrains code quality inspection suite before each release. This can be executed from a Visual Studio Code terminal using the following script:

Build.ps1 codestyle inspect

Tests

All new features must be thoroughly tested. The code must work seamlessly with any valid C# code. Our policy is that Metalama should support all valid C# code, and users should never be required to refactor their code to accommodate Metalama.