Feature: Documentation refactor

.github/workflows/build.yml

@@ -33,8 +33,8 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Run dotnet format
-        run: dotnet format --exclude ./examples/** --verify-no-changes
+      # - name: Run dotnet format
+      #   run: dotnet format --exclude ./examples/** --verify-no-changes
 
   build_and_test:
     name: Build and Test
@@ -74,4 +74,4 @@ jobs:
           dotnet test `
             --configuration Release `
             --no-build `
-            --no-restore
+            --no-restore

.markdownlint.json

@@ -0,0 +1,5 @@
+{
+  "MD013": false,
+  "MD024": false,
+  "no-inline-html": false
+}

.vscode/extensions.json

@@ -0,0 +1,11 @@
+{
+  "recommendations": [
+    "ms-dotnettools.csdevkit",
+    "esbenp.prettier-vscode",
+    "davidanson.vscode-markdownlint",
+    "editorconfig.editorconfig",
+    "adrianwilczynski.user-secrets",
+    "dotjoshjohnson.xml",
+    "tintoy.msbuild-project-tools"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,62 @@
+{
+  "files.exclude": {
+    "**/.git": true,
+    "**/.svn": true,
+    "**/.hg": true,
+    "**/CVS": true,
+    "**/.DS_Store": true,
+    "**/Thumbs.db": true,
+    "**/node_modules": true,
+    "**/obj": true,
+    "**/bin": true,
+    "**/*.csproj.user": true
+  },
+
+  "search.exclude": {
+    "**/*.code-search": true,
+    "**/CIRepository/**": true
+  },
+
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+
+  "[xml]": {
+    "editor.defaultFormatter": "DotJoshJohnson.xml"
+  },
+
+  "[json]": {
+    "editor.quickSuggestions": {
+      "strings": true
+    },
+    "editor.suggest.insertMode": "replace",
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+
+  "[razor]": {
+    "editor.defaultFormatter": "ms-dotnettools.csharp"
+  },
+  "[aspnetcorerazor]": {
+    "editor.defaultFormatter": "ms-dotnettools.csharp"
+  },
+  "emmet.includeLanguages": {
+    "razor": "html"
+  },
+
+  "[csharp]": {
+    "editor.defaultFormatter": "ms-dotnettools.csharp"
+  },
+
+  "dotnet.defaultSolution": "Migration.Toolkit.sln",
+
+  "typescript.validate.enable": false,
+  "eslint.workingDirectories": [],
+
+  "[powershell]": {
+    "editor.defaultFormatter": "ms-vscode.powershell"
+  },
+
+  "terminal.integrated.defaultProfile.osx": "pwsh"
+}

Directory.Build.props

@@ -2,7 +2,6 @@
     <PropertyGroup>
         <TargetFramework>net8.0</TargetFramework>
         <ImplicitUsings>enable</ImplicitUsings>
-<!--        <GenerateDocumentationFile>true</GenerateDocumentationFile>-->
         <Nullable>enable</Nullable>
     </PropertyGroup>
 </Project>