refactor: Remove obsolete docfx tools-dep (#1306)

* refactor: Remove obsolete docfx tools-dep

* refactor: Correct docs and make docfx run inside IDE

* refactor: readded launchsettings.json

Author: linkdotnet

.config/dotnet-tools.json

@@ -7,12 +7,6 @@
       "commands": [
         "dotnet-serve"
       ]
-    },
-    "docfx": {
-      "version": "2.74.0",
-      "commands": [
-        "docfx"
-      ]
     }
   }
 }

.github/workflows/docs-deploy.yml

@@ -86,7 +86,7 @@ jobs:
       - name: 🛠️ Building bUnit
         run: dotnet build /p:PublicRelease=true
 
-      - name: 🛠️ Verfiy docs samples
+      - name: 🛠️ Verify docs samples
         run: dotnet test docs/samples/samples.sln
 
       - name: 📄 Building docs

docs/README.md

@@ -21,16 +21,17 @@ These sample components, source files, and tests source files are included in th
 The following chapter describes how you can run and view the documentation locally
 
 ### Requirements
-You will need the following tools installed:
+You will need the following tool installed:
 * The [`dotnet serve` tool](https://github.com/natemcmaster/dotnet-serve)
-* [DocFx](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html#2-use-docfx-as-a-command-line-tool) to generate the html files
+* [DocFx](https://dotnet.github.io/docfx/tutorial/docfx_getting_started).
 
 ### View the documentation
 
-1. From `docs/site` run `dotnet build`. If you get warnings from running `dotnet build`, try running it again.
-2. From `docs/` run `docfx`. This will generate all the html site based on the markdown files.
-3. From `docs/` run `serve-docs.cmd`. This will start up a local web server, hosting the generated documentation site.
-4. After changing samples from `docs/samples`, run `dotnet test`. This will compile the sample components and run the sample tests.
+1. Build the `bunit.sln` solution in the root folder.
+2. From `docs/site` run `dotnet build`. If you get warnings from running `dotnet build`, try running it again.
+3. Inside `docs/site` run `dotnet run` to start the generation.
+4. From `docs/` run `serve-docs.cmd`. This will start up a local web server, hosting the generated documentation site.
+5. After changing samples from `docs/samples`, run `dotnet test`. This will compile the sample components and run the sample tests.
 
 ## Documentation Writing Rules
 

docs/site/Properties/launchsettings.json

@@ -0,0 +1,11 @@
+{
+  "profiles": {
+    "Site": {
+      "commandName": "Project",
+      "environmentVariables": {
+        "DOTNET_ENVIRONMENT": "Development"
+      },
+      "workingDirectory": "$(MSBuildProjectDirectory)"
+    }
+  }
+}