Skip to content

Commit 42cca9f

Browse files
committed
chore: Updated README.md
1 parent 26d3115 commit 42cca9f

1 file changed

Lines changed: 56 additions & 2 deletions

File tree

README.md

Lines changed: 56 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,56 @@
1-
# Escendit.Tools.CodeAnalysis.xUnitAnalyzers
2-
xunit Analyzer Defaults
1+
# NuGet Package: Escendit.Tools.CodeAnalysis.xUnitAnalyzers
2+
3+
This NuGet package leverages the power of xunit analyzers
4+
to enforce code quality standards that are tailored to the organization's specific needs.
5+
By default,
6+
the package uses a set of analyzer rules that have been configured to align with the organization's coding practices,
7+
ensuring that our code is always compliant and maintainable.
8+
9+
Key features:
10+
11+
- Utilize xunit analyzers for powerful and customizable code analysis
12+
- Defaults suited to the organization's coding practices
13+
- Ensures code compliance and maintainability
14+
15+
## Installation
16+
To install this package, use the NuGet Package Manager Console:
17+
18+
```shell
19+
PM> Install-Package Escendit.Tools.CodeAnalysis.xUnitAnalyzers
20+
```
21+
Or you can search for "Escendit.Tools.CodeAnalysis.xUnitAnalyzers"
22+
in the NuGet Package Manager UI and install it from there.
23+
24+
## Usage
25+
After installing the package, the MSBuild and .editorconfig properties will be set automatically.
26+
- You can modify the MSBuild properties by updating the values in your .csproj or .vbproj file.
27+
- You can modify the .editorconfig properties by creating .editorconfig file and overriding the default values.
28+
29+
## Configuration
30+
31+
The NuGet package includes the following default rules and severity levels:
32+
33+
Currently, vendor provides the defaults.
34+
35+
To modify the severity level of a rule, you can add the following code to your .editorconfig file:
36+
37+
```editorconfig
38+
dotnet_diagnostic.<Rule>.severity = <Severity>
39+
```
40+
41+
For example, to change the severity level of `xUnit9999` to "error", add the following line to your .editorconfig file:
42+
43+
```editorconfig
44+
dotnet_diagnostic.xUnit9999.severity = error
45+
```
46+
Browse [here](https://xunit.net/xunit.analyzers/rules/) for available rules.
47+
48+
## Contributing
49+
If you find a bug or have a feature request, please create an issue in the GitHub repository.
50+
51+
To contribute code, fork the repository and submit a pull request.
52+
Please ensure that your code follows the project's coding standards and is thoroughly tested.
53+
54+
## License
55+
This package is released under the MIT License. See the LICENSE.txt file for details.
56+

0 commit comments

Comments
 (0)