fsprojects · knocte · Nov 20, 2025 · Nov 17, 2025 · Nov 17, 2025 · Nov 17, 2025
diff --git a/.github/workflows/build+test+deploy.yml b/.github/workflows/build+test+deploy.yml
@@ -27,8 +27,6 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Restore tools
-      run: dotnet tool restore
     - name: Restore dependencies
       run: dotnet restore
     - name: Build

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -11,8 +11,6 @@ Use the issues tracker for:
 * [feature requests](#feature-requests)
 * [submitting pull requests](#pull-requests)
 
-Please **do not** use the issue tracker for personal or commercial support requests.
-
 ## Bug reports
 
 A bug is either a _demonstrable problem_ that is caused by the code in the repository,
@@ -143,3 +141,8 @@ in order to craft an excellent pull request:
    git checkout <your-topic-branch>
    git rebase master
    ```
+
+## Maintaining the project
+
+If you have become a maintainer, please don't forget to follow [the Releasing Guidelines](./RELEASE.md).
+
diff --git a/README.md b/README.md
@@ -2,9 +2,9 @@
 
 FSharpLint is a static analysis tool for F#. Like many other software linters, it analyzes your source code (using both typed and untyped syntax trees) and highlights any violations of defined F# coding rules. There are various kinds of rules:
 
-* **Conventions:** ensures that your API members follow project- or solution-wide naming conventions.
-* **Smells:** warns about logic that may pose maintainability problems or potential downsides.
-* **Formatting:** checks that code is indented and structured according to specified cosmetic standards.
+* **Conventions:** ensures that your API members follow project- or solution-wide naming standards, or that your source code is structured in parts that don't surpass excessive (and configurable) certain lengths.
+* **Smells:** warns about logic that may indicate defects, or pose maintainability problems or downsides.
+* **Formatting:** checks that code is indented and structured according to specified cosmetic standards (beware, this kind of rules are deprecated in favour of more mature tools such as `fantomas`).
 
 The tool is configurable via JSON and can be run as a console app or as an MSBuild task. It also provides an interface for easy integration into other software.
 
@@ -38,24 +38,19 @@ Package | Version
 ## How to build
 
 1. Make sure you've installed the .NET version defined in [global.json](global.json)
-2. Run `dotnet tool restore` to install all developer tools required to build the project
-3. Run `make` to build (which executes the `Build` target from the FAKE-based [build script](build.fsx))
-4. To run tests use `make check`
-5. To build documentation use `make docs`
+2. Run `make` to build (which executes the `Build` target from the FAKE-based [build script](build.fsx))
+3. To run tests use `make check`
+4. To build documentation use `make docs`
 
 ## How to work with documentation
 
 1. Make sure you've installed the .NET version defined in [global.json](global.json)
 2. Run `dotnet tool restore` to install all developer tools required to build the project
-3. Run `dotnet fsi build.fsx` to build default target of [build script](build.fsx)
-4. Build documentation to make sure everything is fine with `dotnet fsi build.fsx -t Docs`
+3. Run `make` to build the default target of the [build script](build.fsx)
+4. Build documentation to make sure everything is fine with `make docs`
 5. Go to docs folder `cd docs` and start Fornax in watch mode `dotnet fornax watch`
 6. Your documentation should be now accessible on `localhost:8080` and will be regenerated on every file save
 
-## How to release
-
-Please [read the Releasing Guidelines](./RELEASE.md) if you're a maintainer.
-
 ## How to contribute
 
 Bug reports, feature requests, and pull requests are very welcome! Please [read the Contribution Guidelines](./CONTRIBUTING.md)

diff --git a/src/FSharpLint.Core/FSharpLint.Core.fsproj b/src/FSharpLint.Core/FSharpLint.Core.fsproj
@@ -43,10 +43,10 @@
     <Compile Include="Rules\Formatting\Spacing\ModuleDeclSpacing.fs" />
     <Compile Include="Rules\Formatting\Spacing\ClassMemberSpacing.fs" />
     <Compile Include="Rules\Formatting\TypedItemSpacing.fs" />
-    <Compile Include="Rules\Formatting\TypePrefixing.fs" />
+    <Compile Include="Rules\Conventions\TypePrefixing.fs" />
     <Compile Include="Rules\Formatting\UnionDefinitionIndentation.fs" />
     <Compile Include="Rules\Conventions\UnneededRecKeyword.fs" />
-    <Compile Include="Rules\Conventions\AsyncExceptionWithoutReturn.fs" />
+    <Compile Include="Rules\Smells\AsyncExceptionWithoutReturn.fs" />
     <Compile Include="Rules\Conventions\FavourStaticEmptyFields.fs" />
     <Compile Include="Rules\Conventions\RecursiveAsyncFunction.fs" />
     <Compile Include="Rules\Conventions\RedundantNewKeyword.fs" />
@@ -57,17 +57,17 @@
     <Compile Include="Rules\Conventions\FavourConsistentThis.fs" />
     <Compile Include="Rules\Conventions\AvoidSinglePipeOperator.fs" />
     <Compile Include="Rules\Conventions\SuggestUseAutoProperty.fs" />
-    <Compile Include="Rules\Conventions\UsedUnderscorePrefixedElements.fs" />
+    <Compile Include="Rules\Smells\UsedUnderscorePrefixedElements.fs" />
     <Compile Include="Rules\Conventions\FavourNonMutablePropertyInitialization.fs" />
     <Compile Include="Rules\Conventions\EnsureTailCallDiagnosticsInRecursiveFunctions.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\RaiseWithTooManyArgumentsHelper.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\FailwithWithSingleArgument.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\RaiseWithSingleArgument.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\NullArgWithSingleArgument.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\InvalidOpWithSingleArgument.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\InvalidArgWithTwoArguments.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\FailwithfWithArgumentsMatchingFormatString.fs" />
-    <Compile Include="Rules\Conventions\RaiseWithTooManyArguments\FailwithBadUsage.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\RaiseWithTooManyArgumentsHelper.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\FailwithWithSingleArgument.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\RaiseWithSingleArgument.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\NullArgWithSingleArgument.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\InvalidOpWithSingleArgument.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\InvalidArgWithTwoArguments.fs" />
+    <Compile Include="Rules\Smells\RaiseWithTooManyArguments\FailwithfWithArgumentsMatchingFormatString.fs" />
+    <Compile Include="Rules\Conventions\FailwithBadUsage.fs" />
     <Compile Include="Rules\Conventions\SourceLength\SourceLengthHelper.fs" />
     <Compile Include="Rules\Conventions\SourceLength\MaxLinesInLambdaFunction.fs" />
     <Compile Include="Rules\Conventions\SourceLength\MaxLinesInMatchLambdaFunction.fs" />
@@ -116,13 +116,13 @@
     <Compile Include="Rules\Conventions\Binding\UselessBinding.fs" />
     <Compile Include="Rules\Conventions\Binding\TupleOfWildcards.fs" />
     <Compile Include="Rules\Conventions\Binding\FavourAsKeyword.fs" />
-    <Compile Include="Rules\Conventions\AvoidTooShortNames.fs" />
-    <Compile Include="Rules\Typography\Indentation.fs" />
-    <Compile Include="Rules\Typography\MaxCharactersOnLine.fs" />
-    <Compile Include="Rules\Typography\TrailingWhitespaceOnLine.fs" />
-    <Compile Include="Rules\Typography\MaxLinesInFile.fs" />
-    <Compile Include="Rules\Typography\TrailingNewLineInFile.fs" />
-    <Compile Include="Rules\Typography\NoTabCharacters.fs" />
+    <Compile Include="Rules\Conventions\Naming\AvoidTooShortNames.fs" />
+    <Compile Include="Rules\Formatting\Typography\Indentation.fs" />
+    <Compile Include="Rules\Formatting\Typography\MaxCharactersOnLine.fs" />
+    <Compile Include="Rules\Formatting\Typography\TrailingWhitespaceOnLine.fs" />
+    <Compile Include="Rules\Conventions\SourceLength\MaxLinesInFile.fs" />
+    <Compile Include="Rules\Formatting\Typography\TrailingNewLineInFile.fs" />
+    <Compile Include="Rules\Formatting\Typography\NoTabCharacters.fs" />
     <Compile Include="Rules\Hints\HintsHelper.fs" />
     <Compile Include="Rules\Hints\HintMatcher.fs" />
     <!-- Application  -->

diff --git a/...eWithTooManyArguments/FailwithBadUsage.fs → ...ore/Rules/Conventions/FailwithBadUsage.fs b/...eWithTooManyArguments/FailwithBadUsage.fs → ...ore/Rules/Conventions/FailwithBadUsage.fs
diff --git a/...e/Rules/Conventions/AvoidTooShortNames.fs → .../Conventions/Naming/AvoidTooShortNames.fs b/...e/Rules/Conventions/AvoidTooShortNames.fs → .../Conventions/Naming/AvoidTooShortNames.fs
diff --git a/...t.Core/Rules/Typography/MaxLinesInFile.fs → ...onventions/SourceLength/MaxLinesInFile.fs b/...t.Core/Rules/Typography/MaxLinesInFile.fs → ...onventions/SourceLength/MaxLinesInFile.fs
diff --git a/...nt.Core/Rules/Formatting/TypePrefixing.fs → ...t.Core/Rules/Conventions/TypePrefixing.fs b/...nt.Core/Rules/Formatting/TypePrefixing.fs → ...t.Core/Rules/Conventions/TypePrefixing.fs
diff --git a/...Lint.Core/Rules/Typography/Indentation.fs → ...ules/Formatting/Typography/Indentation.fs b/...Lint.Core/Rules/Typography/Indentation.fs → ...ules/Formatting/Typography/Indentation.fs
diff --git a/...e/Rules/Typography/MaxCharactersOnLine.fs → ...matting/Typography/MaxCharactersOnLine.fs b/...e/Rules/Typography/MaxCharactersOnLine.fs → ...matting/Typography/MaxCharactersOnLine.fs
diff --git a/....Core/Rules/Typography/NoTabCharacters.fs → .../Formatting/Typography/NoTabCharacters.fs b/....Core/Rules/Typography/NoTabCharacters.fs → .../Formatting/Typography/NoTabCharacters.fs
diff --git a/...Rules/Typography/TrailingNewLineInFile.fs → ...tting/Typography/TrailingNewLineInFile.fs b/...Rules/Typography/TrailingNewLineInFile.fs → ...tting/Typography/TrailingNewLineInFile.fs
diff --git a/...es/Typography/TrailingWhitespaceOnLine.fs → ...ng/Typography/TrailingWhitespaceOnLine.fs b/...es/Typography/TrailingWhitespaceOnLine.fs → ...ng/Typography/TrailingWhitespaceOnLine.fs
diff --git a/...onventions/AsyncExceptionWithoutReturn.fs → ...les/Smells/AsyncExceptionWithoutReturn.fs b/...onventions/AsyncExceptionWithoutReturn.fs → ...les/Smells/AsyncExceptionWithoutReturn.fs
diff --git a/...nyArguments/FailwithWithSingleArgument.fs → ...nyArguments/FailwithWithSingleArgument.fs b/...nyArguments/FailwithWithSingleArgument.fs → ...nyArguments/FailwithWithSingleArgument.fs
diff --git a/...withfWithArgumentsMatchingFormatString.fs → ...withfWithArgumentsMatchingFormatString.fs b/...withfWithArgumentsMatchingFormatString.fs → ...withfWithArgumentsMatchingFormatString.fs
diff --git a/...nyArguments/InvalidArgWithTwoArguments.fs → ...nyArguments/InvalidArgWithTwoArguments.fs b/...nyArguments/InvalidArgWithTwoArguments.fs → ...nyArguments/InvalidArgWithTwoArguments.fs
diff --git a/...yArguments/InvalidOpWithSingleArgument.fs → ...yArguments/InvalidOpWithSingleArgument.fs b/...yArguments/InvalidOpWithSingleArgument.fs → ...yArguments/InvalidOpWithSingleArgument.fs
diff --git a/...anyArguments/NullArgWithSingleArgument.fs → ...anyArguments/NullArgWithSingleArgument.fs b/...anyArguments/NullArgWithSingleArgument.fs → ...anyArguments/NullArgWithSingleArgument.fs
diff --git a/...oManyArguments/RaiseWithSingleArgument.fs → ...oManyArguments/RaiseWithSingleArgument.fs b/...oManyArguments/RaiseWithSingleArgument.fs → ...oManyArguments/RaiseWithSingleArgument.fs
diff --git a/...uments/RaiseWithTooManyArgumentsHelper.fs → ...uments/RaiseWithTooManyArgumentsHelper.fs b/...uments/RaiseWithTooManyArgumentsHelper.fs → ...uments/RaiseWithTooManyArgumentsHelper.fs
diff --git a/...entions/UsedUnderscorePrefixedElements.fs → .../Smells/UsedUnderscorePrefixedElements.fs b/...entions/UsedUnderscorePrefixedElements.fs → .../Smells/UsedUnderscorePrefixedElements.fs