Align help links with grouped documentation

MariusStorhaug · Copilot · MariusStorhaug · commit d751c66a6476 · 2026-07-25T23:41:27.000+02:00
Co-authored-by: Copilot App &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/src/functions/private/Auth/Get-DomeneshopConfig.ps1 b/src/functions/private/Auth/Get-DomeneshopConfig.ps1
@@ -26,6 +26,9 @@ function Get-DomeneshopConfig {
         .NOTES
         This read helper does not create or update Context vault entries.
 
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Get-DomeneshopContext
+
         .LINK
         https://psmodule.io/Context/
     #>
diff --git a/src/functions/private/Auth/Resolve-DomeneshopContext.ps1 b/src/functions/private/Auth/Resolve-DomeneshopContext.ps1
@@ -24,6 +24,9 @@ function Resolve-DomeneshopContext {
         .NOTES
         This helper never selects or defaults a context. Public commands own that behavior.
 
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Get-DomeneshopContext
+
         .LINK
         https://psmodule.io/Context/
     #>
diff --git a/src/functions/private/Auth/Set-DomeneshopDefaultContext.ps1 b/src/functions/private/Auth/Set-DomeneshopDefaultContext.ps1
@@ -26,6 +26,9 @@ function Set-DomeneshopDefaultContext {
         .NOTES
         Supports WhatIf and Confirm before changing the module configuration.
 
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Connect-DomeneshopAccount
+
         .LINK
         https://psmodule.io/Context/
     #>
diff --git a/src/functions/private/Auth/Test-DomeneshopContextName.ps1 b/src/functions/private/Auth/Test-DomeneshopContextName.ps1
@@ -23,6 +23,9 @@ function Test-DomeneshopContextName {
 
         .NOTES
         Throws when the context name is reserved.
+
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Connect-DomeneshopAccount
     #>
     [OutputType([bool])]
     [CmdletBinding()]
diff --git a/src/functions/private/Auth/Test-DomeneshopSecret.ps1 b/src/functions/private/Auth/Test-DomeneshopSecret.ps1
@@ -23,6 +23,9 @@ function Test-DomeneshopSecret {
 
         .NOTES
         Supported values are String and SecureString.
+
+        .LINK
+        https://psmodule.io/Domeneshop/Functions/Auth/Connect-DomeneshopAccount
     #>
     [OutputType([bool])]
     [CmdletBinding()]
diff --git a/src/functions/public/Auth/Connect-DomeneshopAccount.ps1 b/src/functions/public/Auth/Connect-DomeneshopAccount.ps1
@@ -34,7 +34,7 @@ function Connect-DomeneshopAccount {
         Credentials are encrypted by the Context module.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Connect-DomeneshopAccount/
+        https://psmodule.io/Domeneshop/Functions/Auth/Connect-DomeneshopAccount
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Auth/Get-DomeneshopContext.ps1 b/src/functions/public/Auth/Get-DomeneshopContext.ps1
@@ -32,7 +32,7 @@ function Get-DomeneshopContext {
         The configuration entry used to track the default is excluded from list output.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Get-DomeneshopContext/
+        https://psmodule.io/Domeneshop/Functions/Auth/Get-DomeneshopContext
 
         .LINK
         https://psmodule.io/Context/
diff --git a/src/functions/public/Ddns/Update-DomeneshopDdns.ps1 b/src/functions/public/Ddns/Update-DomeneshopDdns.ps1
@@ -25,7 +25,7 @@ function Update-DomeneshopDdns {
         Uses the caller's public IP address when MyIP is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Update-DomeneshopDdns/
+        https://psmodule.io/Domeneshop/Functions/Ddns/Update-DomeneshopDdns
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Dns/Add-DomeneshopDnsRecord.ps1 b/src/functions/public/Dns/Add-DomeneshopDnsRecord.ps1
@@ -25,7 +25,7 @@ function Add-DomeneshopDnsRecord {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Add-DomeneshopDnsRecord/
+        https://psmodule.io/Domeneshop/Functions/Dns/Add-DomeneshopDnsRecord
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Dns/Get-DomeneshopDnsRecord.ps1 b/src/functions/public/Dns/Get-DomeneshopDnsRecord.ps1
@@ -30,7 +30,7 @@ function Get-DomeneshopDnsRecord {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Get-DomeneshopDnsRecord/
+        https://psmodule.io/Domeneshop/Functions/Dns/Get-DomeneshopDnsRecord
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Dns/Remove-DomeneshopDnsRecord.ps1 b/src/functions/public/Dns/Remove-DomeneshopDnsRecord.ps1
@@ -25,7 +25,7 @@ function Remove-DomeneshopDnsRecord {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Remove-DomeneshopDnsRecord/
+        https://psmodule.io/Domeneshop/Functions/Dns/Remove-DomeneshopDnsRecord
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Dns/Set-DomeneshopDnsRecord.ps1 b/src/functions/public/Dns/Set-DomeneshopDnsRecord.ps1
@@ -25,7 +25,7 @@ function Set-DomeneshopDnsRecord {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Set-DomeneshopDnsRecord/
+        https://psmodule.io/Domeneshop/Functions/Dns/Set-DomeneshopDnsRecord
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Domains/Get-DomeneshopDomain.ps1 b/src/functions/public/Domains/Get-DomeneshopDomain.ps1
@@ -28,7 +28,7 @@ function Get-DomeneshopDomain {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Get-DomeneshopDomain/
+        https://psmodule.io/Domeneshop/Functions/Domains/Get-DomeneshopDomain
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Forwards/Add-DomeneshopForward.ps1 b/src/functions/public/Forwards/Add-DomeneshopForward.ps1
@@ -29,7 +29,7 @@ function Add-DomeneshopForward {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Add-DomeneshopForward/
+        https://psmodule.io/Domeneshop/Functions/Forwards/Add-DomeneshopForward
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Forwards/Get-DomeneshopForward.ps1 b/src/functions/public/Forwards/Get-DomeneshopForward.ps1
@@ -30,7 +30,7 @@ function Get-DomeneshopForward {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Get-DomeneshopForward/
+        https://psmodule.io/Domeneshop/Functions/Forwards/Get-DomeneshopForward
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Forwards/Remove-DomeneshopForward.ps1 b/src/functions/public/Forwards/Remove-DomeneshopForward.ps1
@@ -25,7 +25,7 @@ function Remove-DomeneshopForward {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Remove-DomeneshopForward/
+        https://psmodule.io/Domeneshop/Functions/Forwards/Remove-DomeneshopForward
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Forwards/Set-DomeneshopForward.ps1 b/src/functions/public/Forwards/Set-DomeneshopForward.ps1
@@ -29,7 +29,7 @@ function Set-DomeneshopForward {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Set-DomeneshopForward/
+        https://psmodule.io/Domeneshop/Functions/Forwards/Set-DomeneshopForward
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/src/functions/public/Get-PSModuleTest.ps1 b/src/functions/public/Get-PSModuleTest.ps1
@@ -25,7 +25,7 @@
         This command is retained as the module's baseline smoke-test command.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Get-PSModuleTest/
+        https://psmodule.io/Domeneshop/Functions/Get-PSModuleTest
 
         .LINK
         https://github.com/PSModule/Domeneshop
diff --git a/src/functions/public/Invoices/Get-DomeneshopInvoice.ps1 b/src/functions/public/Invoices/Get-DomeneshopInvoice.ps1
@@ -30,7 +30,7 @@ function Get-DomeneshopInvoice {
         Uses the default context when Context is omitted.
 
         .LINK
-        https://psmodule.io/Domeneshop/Functions/Get-DomeneshopInvoice/
+        https://psmodule.io/Domeneshop/Functions/Invoices/Get-DomeneshopInvoice
 
         .LINK
         https://api.domeneshop.no/docs/
diff --git a/tests/PublicHelpLinks.Tests.ps1 b/tests/PublicHelpLinks.Tests.ps1
@@ -15,19 +15,28 @@ $testCases = Get-ChildItem -Path $publicFunctionsPath -Filter '*.ps1' -Recurse -
     ForEach-Object {
         @{
             FunctionName = $_.BaseName
+            Group        = if ($_.DirectoryName -eq $publicFunctionsPath) {
+                $null
+            } else {
+                Split-Path -Path $_.DirectoryName -Leaf
+            }
             Path         = $_.FullName
         }
     }
 
 Describe 'Public function help links' {
     It 'puts the canonical documentation link first for <FunctionName>' -ForEach $testCases {
-        param($FunctionName, $Path)
+        param($FunctionName, $Group, $Path)
 
         $content = Get-Content -Path $Path -Raw
         $links = [regex]::Matches($content, '(?ms)^\s*\.LINK\s*\r?\n\s*(?<Uri>\S+)')
+        $expectedLink = if ($Group) {
+            "https://psmodule.io/Domeneshop/Functions/$Group/$FunctionName"
+        } else {
+            "https://psmodule.io/Domeneshop/Functions/$FunctionName"
+        }
 
         $links.Count | Should -BeGreaterThan 0
-        $links[0].Groups['Uri'].Value |
-            Should -Be "https://psmodule.io/Domeneshop/Functions/$FunctionName/"
+        $links[0].Groups['Uri'].Value | Should -Be $expectedLink
     }
 }
