There are several ways to contribute to this project. One can try things out, report bugs, propose improvements and new functionality, work on issues (for new contributors especially the issues marked with the labels help wanted and Good First Issue), and in general join in the conversations.
This project is still very much in its early stages, so the more eyes that take a look at the code, try out the analyzers on existing test etc. the better. So please try to use the analyzers with your NUnit test projects and provide feedback. The input is much appreciated.
The analyzers are still in its alpha release, so it is likely to contain a number of unknown bugs and/or missing some essential features. So try it out and provide feedback, such as bug reports or requests for improvements or new functionality.
For bug reports please provide as much information as possible:
- A short and clear title that describes the bug
- Version of the package
- Include steps to reproduce the issue
- The expected and the actual behaviour (preferably including small code examples)
For requests for improvements and new functionality please provide:
- A short and clear title that describes the feature
- A more thorough description of the feature (preferably including small code examples)
- Possibly how the feature relates to existing functionality
Please provide pull requests for issues, but before starting on a pull request comment in the issue such that we avoid duplicated work - also comment if you stop working on the issue. The issues marked with the labels help wanted and Good First Issue should be most accessible, and be a good starting ground for new contributors.
The coding standards is specified in the .editorconfig, and otherwise try to follow the existing codebase. Please also supply tests for changes - if the change is possible to test.
Note that by contributing to NUnit.Analyzers, you assert that:
- The contribution is your own original work.
- You have the right to assign the copyright for the work (it is not owned by your employer, or you have been given copyright assignment in writing).
- You license the contribution under the terms applied to the rest of the NUnit.Analyzers project.
- You agree to follow the code of conduct.
First, make sure you have the right tools and templates on your machine. You'll need Visual Studio 2019 version 16.3 (or newer) and the .NET Compiler Platform SDK. The .NET Compiler Platform SDK can be installed via the Visual Studio Installer under the Individual components tab and check the box for .NET Compiler Platform SDK (at the top of the Compilers, build tools, and runtimes section).
The project can now be built from within Visual Studio, or by using the Cake script in the root folder.
From Visual Studio one can debug the analyzers by adding a small test that illustrates the problem (get inspiration from the existing tests - depending on whether it is a problem with a diagnostic or a codefix). Add a breakpoint to the relevant method, compile and run the test from within Visual Studio, and you can now debug the analyzer code.
The command .\build.ps1 will restore the packages necessary to build the solution, build the projects, and then run the tests. The script can also build the projects in Release mode using the option --configuration=Release or create NuGet Packages using the option --target=Pack. This will create a NuGet package under package\Debug\ (for a Debug build) and the file will be named NUnit.Analyzers.***.nupkg where *** depends upon the build type (Debug vs. Release) and the version. The NuGet package can then be referenced from another project.