Merge branch 'main' of https://github.com/nsubstitute/NSubstitute

.github/workflows/release_documentation.yml

@@ -0,0 +1,33 @@
+name: Release documentation
+on:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: |
+            9.0.x
+            8.0.x
+
+      - name: Setup docfx
+        run: dotnet tool install -g docfx
+
+      - name: Build documentation
+        run: docfx build
+        working-directory: ./docs
+
+      - name: Upload documentation
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs
+          path: |
+            ./docs/_site
+          retention-days: 7
+          compression-level: 9

.github/workflows/release_packages.yml

@@ -0,0 +1,27 @@
+name: Release packages
+on:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+
+      - name: Build package
+        run: dotnet pack src/NSubstitute/NSubstitute.csproj -p:CI=true
+
+      - name: Upload packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: packages
+          path: |
+            bin/Release/NSubstitute/*.nupkg
+            bin/Release/NSubstitute/*.snupkg
+          retention-days: 7

.github/workflows/build_and_test.yml → .github/workflows/test.yml

@@ -1,4 +1,4 @@
-name: Build, Test, and Format
+name: Build, Test, and Format verification
 on:
   push:
     branches:
@@ -10,7 +10,7 @@ jobs:
     strategy:
       matrix:
         os: [windows-latest, ubuntu-latest, macOS-latest]
-        framework: [net8.0]
+        framework: [net9.0, net8.0]
         include:
           - os: windows-latest
             framework: net462
@@ -24,6 +24,7 @@ jobs:
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: |
+            9.0.x
             8.0.x
 
       - name: Build
@@ -37,24 +38,16 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: |
+            9.0.x
             8.0.x
 
-      # used for documentation
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.2'
-          bundler-cache: true
-
-      - name: Build all targets
-        run: build\build.cmd --target All
+      - name: Build documentation
+        run: dotnet run --project 'build/build.fsproj'
 
   format-verify:
     runs-on: ubuntu-latest
@@ -65,7 +58,7 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: 8.0.x
+          dotnet-version: 9.0.x
 
       - name: Format
         run: dotnet format --verify-no-changes

CHANGELOG.md

@@ -5,7 +5,8 @@
 * [UPDATE] Update github actions steps versions
 * [UPDATE] Remove legacy obsolete API
 * [UPDATE] Mark as obsolete api CompatArg with pre c# 7.0 support
-
+* [NEW] Added .NET 9 to test matrix
+* [UPDATE] Migrate documentation to docfx platform. https://github.com/dotnet/docfx
 
 ### 5.3.0 (October 2024)
 

NSubstitute.sln

@@ -10,9 +10,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{0E2B9095
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{A8AF7D01-6CE4-47B2-9E23-689A53991C3D}"
 	ProjectSection(SolutionItems) = preProject
-		build\build.cmd = build\build.cmd
 		build\build.fs = build\build.fs
-		build\build.sh = build\build.sh
 		build\ExtractDocs.fs = build\ExtractDocs.fs
 	EndProjectSection
 EndProject

README.md

@@ -1,6 +1,6 @@
 NSubstitute
 ========
-[![Build status](https://github.com/nsubstitute/NSubstitute/actions/workflows/build_and_test.yml/badge.svg)](https://github.com/nsubstitute/NSubstitute/actions/workflows/build_and_test.yml)
+[![Build, Test, and Format verification](https://github.com/nsubstitute/NSubstitute/actions/workflows/test.yml/badge.svg)](https://github.com/nsubstitute/NSubstitute/actions/workflows/test.yml)
 [![Nuget](https://img.shields.io/nuget/v/NSubstitute.svg)](https://www.nuget.org/packages/NSubstitute)
 
 Visit the [NSubstitute website](https://nsubstitute.github.io) for more information.

build/ExtractDocs.fs

@@ -1,7 +1,6 @@
 module ExtractDocs
 
 open System
-open System.IO
 open System.Text.RegularExpressions
 
 let LiquidTagRegex = @"```(?<tag>\w+)" +        // Tag start with argument. e.g. "```csharp"