New website (#2775)

This pull request introduces significant changes to the documentation
and build process. It removes outdated documentation files and content
related to Azure DevOps Migration Tools and replaces the Jekyll-based
site generation with Hugo. Below is a summary of the most important
changes:

### Build Process Updates:
* Replaced the Jekyll-based build process with Hugo in
`.github/workflows/main.yml`. This includes setting up Hugo, configuring
the build environment, and updating the output directory to `./public`
instead of `./_site2`.

### Documentation Cleanup:
* Removed outdated documentation files, including `404.md`,
`MigrationTools.Documentation.csproj`, and various `index.md` files for
topics like Endpoints, FieldMaps, Processors, and more. These files
contained deprecated or redundant content.
[[1]](diffhunk://#diff-97ebf6b847bced95d0648ef962a3ab78b3c7c6d1aba2b52cb75f97a30b3a602eL1-L12)
[[2]](diffhunk://#diff-8d70ae8286a3df0c5c01bbcacbe1e45ecf5838bb82e60a1a5d9089c5a06036bbL1-L13)
[[3]](diffhunk://#diff-3424f775f9e81396dbf62faf76dda6f5934afb94ffcc13ea615c673742879641L1-L29)
[[4]](diffhunk://#diff-6e8b7e5850bc21250a329cbf3524d9b64027a866856ce2b7cdcd7a2071502bc0L1-L37)
[[5]](diffhunk://#diff-1fa19c4849eff73f4847d1f3b80c10913a5708446e9f776f20ff2e280fa170abL1-L12)
[[6]](diffhunk://#diff-3709bb29111fea49f7f57f9cf8d264ffd6ce19a89a0c4375cfc6ee79f35f3b51L1-L25)
[[7]](diffhunk://#diff-e7772b698cd680cba25e8ce9cebf5c5ba990084259e72db8d1f80c72ce5e51d8L1-L41)
[[8]](diffhunk://#diff-236846ba750d27a589590a410425aad25d009108f013a872a14a597c1681780fL1-L7)
[[9]](diffhunk://#diff-e8867f2191af401902fcd3eec9f8b3b27614933e6b61f176dec926200181030aL1-L61)
[[10]](diffhunk://#diff-7185f8300d2b6c456326f1602b1c12addbb0df7211a717e77282fd4d2763c9bcL1-L83)
[[11]](diffhunk://#diff-dc2b2f4d7c8991226cde39f682d842fc48a7873aebeba5ce2218a6bc01268484L1-L8)
[[12]](diffhunk://#diff-79029a4aee19f388b7e82ea4c61774709186a66584ba13e49c43dedae4666ef2L1-L33)
[[13]](diffhunk://#diff-e588b83376687f276dab821795b877d695f4be4dd4b26ed46229e5e49d66ac18L1-L39)
[[14]](diffhunk://#diff-13c2a1e46ad11f70be71e09e24e9c02ddbed3b48fb50e715968d7d98469abaa2L1-L13)
[[15]](diffhunk://#diff-c1e52b82b7b0af2afbe2f0c37dd58e381253911965ff41d7fa11850fd47edfa4L1-L109)
[[16]](diffhunk://#diff-d5cd51996e4f15de3711a281fe3568893c2251d9bd6d90b3e34f03c54a5ccd62L1-L28)

These changes streamline the documentation and modernize the build
process, improving maintainability and aligning with current standards.

Author: MrHinsh

.backup/old-jekyll-site-backup.zip

@@ -362,43 +362,38 @@ jobs:
     name: "Build Documentation output"
     runs-on: ubuntu-latest
     if: ${{ success() }}
-    needs: [Setup, build]
+    needs: [Setup]
     env:
       GitVersion_SemVer: ${{ needs.Setup.outputs.GitVersion_SemVer }}
       GitVersion_AssemblySemVer: ${{ needs.Setup.outputs.GitVersion_AssemblySemVer }}
       GitVersion_InformationalVersion: ${{ needs.Setup.outputs.GitVersion_InformationalVersion }}
     steps:
       - uses: actions/checkout@v4
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1 # v1.161.0
-        with:
-          ruby-version: '3.2' # Not needed with a .ruby-version file
-          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-          cache-version: 0 # Increment this number if you need to re-download cached gems
       - uses: cschleiden/replace-tokens@v1
         with:
-          files: '["**/*.html"]'
+          files: '["**/*.html", "**/*.yaml"]'
           tokenPrefix: "#{"
           tokenSuffix: "}#"
         env:
           GitVersion_SemVer: ${{ needs.Setup.outputs.GitVersion_SemVer }}
           GitVersion_AssemblySemVer: ${{ needs.Setup.outputs.GitVersion_AssemblySemVer }}
           GitVersion_InformationalVersion: ${{ needs.Setup.outputs.GitVersion_InformationalVersion }}
           GitVersion.SemVer: ${{ needs.Setup.outputs.GitVersion_SemVer }}
-      - uses: igsekor/[email protected]
-        id: spellcheck
-        name: Spellcheck
-      - name: Build with Jekyll 2
-        # Outputs to the './_site' directory by default
-        run: bundle exec jekyll build --destination ./_site2/  --baseurl "${{needs.Setup.outputs.nkdAgility_DocsBaseURL_AFD}}"
-        env:
-          JEKYLL_ENV: production
-      # - name: Build Jekyll
-      #   uses: jerryjvl/jekyll-build-action@v1
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v3
+        with:
+          extended: true
+          hugo-version: 'latest'
+      - name: Build
+        run: |
+          $environment = "${{ needs.Setup.outputs.nkdAgility_Ring }}".ToLower()
+          Write-Host "Building site for $environment ";
+          $env:HUGO_ENV = "$environment";
+          hugo --source docs --config hugo.yaml,hugo.$environment.yaml --logLevel debug; # --minify
       - uses: actions/upload-artifact@v4
         with:
           name: AzureDevOpsMigrationTools-Site2
-          path: ./_site2/**/*
+          path: ./public/**/*
 
 
   # GitHubRelease
@@ -412,7 +407,7 @@ jobs:
       GitVersion_InformationalVersion: ${{ needs.Setup.outputs.GitVersion_InformationalVersion }}
       GitVersion_NuGetVersion: ${{ needs.Setup.outputs.GitVersion_NuGetVersion }}
       GitVersion_PreReleaseLabel: ${{ needs.Setup.outputs.GitVersion_PreReleaseLabel }}
-    needs: [build, Setup]
+    needs: [build, Setup, BuildDocs]
     if: ${{ success() && ( needs.Setup.outputs.nkdAgility_RunRelease == 'true' ) }}
     steps:
       - uses: actions/download-artifact@v4

.github/workflows/main.yml

@@ -166,3 +166,4 @@ docs/Reference/Generated/MigrationTools.Host.xml
 logs/
 /staging/
 /docs/Reference/Generated
+/public/

.gitignore

@@ -0,0 +1,192 @@
+#!/usr/bin/env pwsh
+
+<#
+.SYNOPSIS
+    Converts Jekyll-style markdown links to Hugo rel shortcode format
+.DESCRIPTION
+    This script scans all markdown files in the docs/content directory and converts
+    Jekyll-style links (e.g., /setup/installation.md) to Hugo rel shortcode format
+    (e.g., {{ rel "docs/setup/installation" }})
+.EXAMPLE
+    .\FixHugoLinks.ps1
+    .\FixHugoLinks.ps1 -Verbose
+#>
+
+[CmdletBinding()]
+param()
+
+# Define the root directory for content
+$ContentDir = "docs/content"
+$DocsDir = "docs"
+
+# Check if we're in the right directory
+if (-not (Test-Path $ContentDir)) {
+    Write-Error "Content directory '$ContentDir' not found. Please run this script from the repository root."
+    exit 1
+}
+
+# Define link mappings from Jekyll to Hugo format
+$linkMappings = @{
+    # Setup pages
+    "/setup/installation.md"                                                      = "docs/setup/installation"
+    "/setup/permissions.md"                                                       = "docs/setup/permissions"
+    "/setup/reflectedworkitemid.md"                                               = "docs/setup/reflectedworkitemid"
+    
+    # General docs references
+    "/docs/Reference/index.md"                                                    = "docs/reference"
+    "/docs/Reference/v1/Processors/WorkItemMigrationConfig.md"                    = "docs/reference/processors/work-item-tracking-processor"
+    
+    # Processor references (Jekyll _reference format to Hugo)
+    "_reference/reference.processors.tfsworkitemmigrationprocessor.md"            = "docs/reference/processors/tfs-workitem-migration-processor"
+    "_reference/reference.processors.tfsworkitembulkeditprocessor.md"             = "docs/reference/processors/tfs-workitem-bulk-edit-processor"
+    "_reference/reference.processors.tfsworkitemdeleteprocessor.md"               = "docs/reference/processors/tfs-workitem-delete-processor"
+    "_reference/reference.processors.tfsworkitemoverwriteprocessor.md"            = "docs/reference/processors/tfs-workitem-overwrite-processor"
+    "_reference/reference.processors.tfsworkitemoverwriteareasastagsprocessor.md" = "docs/reference/processors/tfs-workitem-overwrite-areas-as-tags-processor"
+    "_reference/reference.processors.workitemtrackingprocessor.md"                = "docs/reference/processors/work-item-tracking-processor"
+    "_reference/reference.processors.azuredevopspipelineprocessor.md"             = "docs/reference/processors/azure-devops-pipeline-processor"
+    "_reference/reference.processors.processdefinitionprocessor.md"               = "docs/reference/processors/process-definition-processor"
+    "_reference/reference.processors.tfssharedqueryprocessor.md"                  = "docs/reference/processors/tfs-shared-query-processor"
+    "_reference/reference.processors.tfsteamsettingsprocessor.md"                 = "docs/reference/processors/tfs-team-settings-processor"
+    "_reference/reference.processors.tfstestconfigurationsmigrationprocessor.md"  = "docs/reference/processors/tfs-test-configurations-migration-processor"
+    "_reference/reference.processors.tfstestplansandsuitesmigrationprocessor.md"  = "docs/reference/processors/tfs-test-plans-and-suites-migration-processor"
+    "_reference/reference.processors.tfstestvariablesmigrationprocessor.md"       = "docs/reference/processors/tfs-test-variables-migration-processor"
+    "_reference/reference.processors.tfsexportprofilepicturefromadprocessor.md"   = "docs/reference/processors/tfs-export-profile-picture-from-a-d-processor"
+    "_reference/reference.processors.tfsexportusersformappingprocessor.md"        = "docs/reference/processors/tfs-export-users-for-mapping-processor"
+    "_reference/reference.processors.tfsimportprofilepictureprocessor.md"         = "docs/reference/processors/tfs-import-profile-picture-processor"
+    "_reference/reference.processors.keepoutboundlinktargetprocessor.md"          = "docs/reference/processors/keep-outbound-link-target-processor"
+    "_reference/reference.processors.outboundlinkcheckingprocessor.md"            = "docs/reference/processors/outbound-link-checking-processor"
+    
+    # Tool references (Jekyll _reference format to Hugo)
+    "_reference/reference.tools.tfsgitrepositorytool.md"                          = "docs/reference/tools/tfs-git-repository-tool"
+    "_reference/reference.tools.tfschangesetmappingtool.md"                       = "docs/reference/tools/tfs-change-set-mapping-tool"
+    "_reference/reference.tools.tfsattachmenttool.md"                             = "docs/reference/tools/tfs-attachment-tool"
+    "_reference/reference.tools.tfsembededimagestool.md"                          = "docs/reference/tools/tfs-embeded-images-tool"
+    "_reference/reference.tools.tfsnodestructuretool.md"                          = "docs/reference/tools/tfs-node-structure-tool"
+    "_reference/reference.tools.tfsrevisionmanagertool.md"                        = "docs/reference/tools/tfs-revision-manager-tool"
+    "_reference/reference.tools.tfsteamsettingstool.md"                           = "docs/reference/tools/tfs-team-settings-tool"
+    "_reference/reference.tools.tfsusermappingtool.md"                            = "docs/reference/tools/tfs-user-mapping-tool"
+    "_reference/reference.tools.tfsvalidaterequiredfieldtool.md"                  = "docs/reference/tools/tfs-validate-required-field-tool"
+    "_reference/reference.tools.tfsworkitemembededlinktool.md"                    = "docs/reference/tools/tfs-work-item-embeded-link-tool"
+    "_reference/reference.tools.tfsworkitemlinktool.md"                           = "docs/reference/tools/tfs-work-item-link-tool"
+    "_reference/reference.tools.workitemtypemappingtool.md"                       = "docs/reference/tools/work-item-type-mapping-tool"
+    "_reference/reference.tools.stringmanipulatortool.md"                         = "docs/reference/tools/string-manipulator-tool"
+    "_reference/reference.tools.fieldmappingtool.md"                              = "docs/reference/tools/field-mapping-tool"
+}
+
+# Function to convert markdown links to Hugo rel shortcode
+function ConvertMarkdownLinksToHugo {
+    param(
+        [string]$filePath,
+        [hashtable]$mappings
+    )
+    
+    $content = Get-Content -Path $filePath -Raw
+    $changesMade = $false
+    
+    Write-Verbose "Processing file: $filePath"
+    
+    # Convert each mapping
+    foreach ($oldLink in $mappings.Keys) {
+        $newLink = $mappings[$oldLink]
+        
+        # Pattern to match markdown links with the old format
+        $pattern = '\[([^\]]+)\]\(' + [regex]::Escape($oldLink) + '\)'
+        $replacement = '[$1]({{< ref "' + $newLink + '" >}})'
+        
+        if ($content -match $pattern) {
+            Write-Verbose "  Converting: $oldLink -> $newLink"
+            $content = $content -replace $pattern, $replacement
+            $changesMade = $true
+        }
+        else {
+            Write-Verbose "  Pattern not found: $pattern"
+        }
+    }
+    
+    # Save the file if changes were made
+    if ($changesMade) {
+        Set-Content -Path $filePath -Value $content -NoNewline
+        Write-Host "Updated: $filePath" -ForegroundColor Green
+        return $true
+    }
+    
+    return $false
+}
+
+# Function to validate Hugo links exist
+function ValidateHugoLinks {
+    param([string]$contentDir)
+    
+    Write-Host "Validating Hugo content structure..." -ForegroundColor Yellow
+    
+    $missingPages = @()
+    foreach ($hugoPath in $linkMappings.Values) {
+        # Convert hugo path to actual file path
+        $relativePath = $hugoPath -replace '^docs/', ''
+        $expectedPath = Join-Path $contentDir "docs" ($relativePath -replace '/', '\') "index.md"
+        if (-not (Test-Path $expectedPath)) {
+            $missingPages += @{
+                HugoPath     = $hugoPath
+                ExpectedFile = $expectedPath
+            }
+        }
+    }
+    
+    if ($missingPages.Count -gt 0) {
+        Write-Warning "Found $($missingPages.Count) missing Hugo pages:"
+        foreach ($missing in $missingPages) {
+            Write-Warning "  Hugo path: $($missing.HugoPath)"
+            Write-Warning "  Expected file: $($missing.ExpectedFile)"
+        }
+        return $false
+    }
+    
+    Write-Host "All Hugo pages exist!" -ForegroundColor Green
+    return $true
+}
+
+# Main execution
+Write-Host "Starting Hugo link conversion..." -ForegroundColor Cyan
+
+# Validate that target Hugo pages exist (disabled for now - Hugo will validate during build)
+# if (-not (ValidateHugoLinks -contentDir $ContentDir)) {
+#     Write-Error "Some target Hugo pages are missing. Please ensure all referenced pages exist before running this script."
+#     exit 1
+# }
+
+# Find all markdown files
+$markdownFiles = Get-ChildItem -Path $ContentDir -Filter "*.md" -Recurse
+
+Write-Host "Found $($markdownFiles.Count) markdown files to process" -ForegroundColor Yellow
+
+$totalUpdated = 0
+
+# Process each markdown file
+foreach ($file in $markdownFiles) {
+    if (ConvertMarkdownLinksToHugo -filePath $file.FullName -mappings $linkMappings) {
+        $totalUpdated++
+    }
+}
+
+Write-Host "`nConversion complete!" -ForegroundColor Cyan
+Write-Host "Files updated: $totalUpdated" -ForegroundColor Green
+
+# Test Hugo build
+Write-Host "`nTesting Hugo build..." -ForegroundColor Yellow
+try {
+    $buildResult = & hugo --source $DocsDir 2>&1
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "Hugo build successful!" -ForegroundColor Green
+        Write-Host "Build output:" -ForegroundColor Gray
+        Write-Host $buildResult -ForegroundColor Gray
+    }
+    else {
+        Write-Error "Hugo build failed!"
+        Write-Host $buildResult -ForegroundColor Red
+    }
+}
+catch {
+    Write-Error "Failed to run Hugo: $($_.Exception.Message)"
+}
+
+Write-Host "`nDone! Please review the changes and test your site." -ForegroundColor Cyan