From c50f9865f4c3afa14c4d9037ebe62492b4b4c2f8 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 12:25:26 +0200 Subject: [PATCH 01/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Improve=20outpu?= =?UTF-8?q?t=20formatting=20and=20streamline=20markdown=20file=20handling?= =?UTF-8?q?=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 4f114d5..a3719fb 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -66,13 +66,17 @@ Force = $true } $null = New-MarkdownCommandHelp @params - Write-Host ' - ✓' -ForegroundColor Green + Write-Host " - $($PSStyle.Foreground.Green)✓$($PSStyle.Reset)" } catch { - Write-Host ' - ✗' -ForegroundColor Red + Write-Host " - $($PSStyle.Foreground.Red)✗$($PSStyle.Reset)" $_ } } + Write-Host '::group::Build docs - Generated files' + Get-ChildItem -Path $docsOutputFolder -Recurse | Select-Object -ExpandProperty FullName + Write-Host '::endgroup::' + Get-ChildItem -Path $DocsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $fileName = $_.Name Write-Host "::group:: - [$fileName]" From 0a86bdbccf0b4e9844c96e346e63d37d45b22833 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 12:32:08 +0200 Subject: [PATCH 02/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Fix=20path=20re?= =?UTF-8?q?solution=20for=20documentation=20output=20folder=20in=20Build-P?= =?UTF-8?q?SModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index a3719fb..416c617 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -73,6 +73,8 @@ } } + $docsOutputFolder = Join-Path $docsOutputFolder $ModuleName | Get-Item + Write-Host '::group::Build docs - Generated files' Get-ChildItem -Path $docsOutputFolder -Recurse | Select-Object -ExpandProperty FullName Write-Host '::endgroup::' From 0b6782969cf8cc5e0fd67dfa89ffbc81c70b68a1 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 12:41:41 +0200 Subject: [PATCH 03/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Refactor=20vari?= =?UTF-8?q?able=20names=20for=20clarity=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 416c617..cb8a42a 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -73,20 +73,20 @@ } } - $docsOutputFolder = Join-Path $docsOutputFolder $ModuleName | Get-Item + $moduleDocsFolder = Join-Path $docsOutputFolder $ModuleName | Get-Item Write-Host '::group::Build docs - Generated files' - Get-ChildItem -Path $docsOutputFolder -Recurse | Select-Object -ExpandProperty FullName + Get-ChildItem -Path $moduleDocsFolder -Recurse | Select-Object -ExpandProperty FullName Write-Host '::endgroup::' - Get-ChildItem -Path $DocsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $fileName = $_.Name Write-Host "::group:: - [$fileName]" Show-FileContent -Path $_ } Write-Host '::group::Build docs - Fix markdown code blocks' - Get-ChildItem -Path $DocsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $content = Get-Content -Path $_.FullName $fixedOpening = $false $newContent = @() @@ -105,7 +105,7 @@ } Write-Host '::group::Build docs - Fix markdown escape characters' - Get-ChildItem -Path $DocsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $content = Get-Content -Path $_.FullName -Raw $content = $content -replace '\\`', '`' $content = $content -replace '\\\[', '[' @@ -118,7 +118,6 @@ Write-Host '::group::Build docs - Structure markdown files to match source files' $PublicFunctionsFolder = Join-Path $ModuleSourceFolder.FullName 'functions\public' | Get-Item - $moduleDocsFolder = Join-Path $DocsOutputFolder.FullName $ModuleName Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $file = $_ $relPath = [System.IO.Path]::GetRelativePath($moduleDocsFolder, $file.FullName) @@ -144,7 +143,6 @@ } Write-Host '::group::Build docs - Move markdown files from source files to docs' - $moduleDocsFolder = Join-Path $DocsOutputFolder.FullName $ModuleName Get-ChildItem -Path $PublicFunctionsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $file = $_ $relPath = [System.IO.Path]::GetRelativePath($PublicFunctionsFolder.FullName, $file.FullName) @@ -159,7 +157,7 @@ } Write-Host '────────────────────────────────────────────────────────────────────────────────' - Get-ChildItem -Path $DocsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $fileName = $_.Name Write-Host "::group:: - [$fileName]" Show-FileContent -Path $_ From 8ca2d563201c003222e62d47b498343edc751515 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 12:49:10 +0200 Subject: [PATCH 04/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Replace=20Impor?= =?UTF-8?q?t-Module=20with=20Get-Module=20for=20improved=20module=20handli?= =?UTF-8?q?ng=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index cb8a42a..85ba81c 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -47,7 +47,7 @@ Write-Host '::group::Build docs - Generate markdown help - Raw' Install-PSModule -Path $ModuleOutputFolder - $moduleInfo = Import-Module -Name $ModuleName -Force -PassThru + $moduleInfo = Get-Module -Name $ModuleName # Get all exported commands from the module $commands = $moduleInfo.ExportedCommands.Values | Where-Object { $_.CommandType -ne 'Alias' } From 8968498576479327a48678fede996d6783ee1118 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 12:51:01 +0200 Subject: [PATCH 05/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Refactor=20to?= =?UTF-8?q?=20use=20$docsOutputFolder=20instead=20of=20$moduleDocsFolder?= =?UTF-8?q?=20for=20improved=20clarity=20in=20documentation=20generation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../helpers/Build-PSModuleDocumentation.ps1 | 22 +++++++++---------- 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 85ba81c..204bf9e 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -73,20 +73,18 @@ } } - $moduleDocsFolder = Join-Path $docsOutputFolder $ModuleName | Get-Item - Write-Host '::group::Build docs - Generated files' - Get-ChildItem -Path $moduleDocsFolder -Recurse | Select-Object -ExpandProperty FullName + Get-ChildItem -Path $docsOutputFolder -Recurse | Select-Object -ExpandProperty FullName Write-Host '::endgroup::' - Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $fileName = $_.Name Write-Host "::group:: - [$fileName]" Show-FileContent -Path $_ } Write-Host '::group::Build docs - Fix markdown code blocks' - Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $content = Get-Content -Path $_.FullName $fixedOpening = $false $newContent = @() @@ -105,7 +103,7 @@ } Write-Host '::group::Build docs - Fix markdown escape characters' - Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $content = Get-Content -Path $_.FullName -Raw $content = $content -replace '\\`', '`' $content = $content -replace '\\\[', '[' @@ -118,16 +116,16 @@ Write-Host '::group::Build docs - Structure markdown files to match source files' $PublicFunctionsFolder = Join-Path $ModuleSourceFolder.FullName 'functions\public' | Get-Item - Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $file = $_ - $relPath = [System.IO.Path]::GetRelativePath($moduleDocsFolder, $file.FullName) + $relPath = [System.IO.Path]::GetRelativePath($docsOutputFolder, $file.FullName) Write-Host " - $relPath" Write-Host " Path: $file" # find the source code file that matches the markdown file $scriptPath = Get-ChildItem -Path $PublicFunctionsFolder -Recurse -Force | Where-Object { $_.Name -eq ($file.BaseName + '.ps1') } Write-Host " PS1 path: $scriptPath" - $docsFilePath = ($scriptPath.FullName).Replace($PublicFunctionsFolder.FullName, $moduleDocsFolder).Replace('.ps1', '.md') + $docsFilePath = ($scriptPath.FullName).Replace($PublicFunctionsFolder.FullName, $docsOutputFolder).Replace('.ps1', '.md') Write-Host " MD path: $docsFilePath" $docsFolderPath = Split-Path -Path $docsFilePath -Parent $null = New-Item -Path $docsFolderPath -ItemType Directory -Force @@ -135,7 +133,7 @@ } Write-Host '::group::Build docs - Fix frontmatter title' - Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $content = Get-Content -Path $_.FullName -Raw # Replace 'title:' with 'ms.title:' in frontmatter only (between --- markers) $content = $content -replace '(?s)^(---.*?)title:(.*?---)', '$1ms.title:$2' @@ -149,7 +147,7 @@ Write-Host " - $relPath" Write-Host " Path: $file" - $docsFilePath = ($file.FullName).Replace($PublicFunctionsFolder.FullName, $moduleDocsFolder) + $docsFilePath = ($file.FullName).Replace($PublicFunctionsFolder.FullName, $docsOutputFolder) Write-Host " MD path: $docsFilePath" $docsFolderPath = Split-Path -Path $docsFilePath -Parent $null = New-Item -Path $docsFolderPath -ItemType Directory -Force @@ -157,7 +155,7 @@ } Write-Host '────────────────────────────────────────────────────────────────────────────────' - Get-ChildItem -Path $moduleDocsFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $fileName = $_.Name Write-Host "::group:: - [$fileName]" Show-FileContent -Path $_ From 342a1ae8d5760b58a5b2f8b1e0acc9e0c6587566 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 12:55:43 +0200 Subject: [PATCH 06/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Replace=20Impor?= =?UTF-8?q?t-Module=20with=20Get-Module=20for=20improved=20module=20handli?= =?UTF-8?q?ng=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 204bf9e..63dd813 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -47,7 +47,7 @@ Write-Host '::group::Build docs - Generate markdown help - Raw' Install-PSModule -Path $ModuleOutputFolder - $moduleInfo = Get-Module -Name $ModuleName + $moduleInfo = Import-Module -Name $ModuleName -PassThru -Verbose:$false # Get all exported commands from the module $commands = $moduleInfo.ExportedCommands.Values | Where-Object { $_.CommandType -ne 'Alias' } From d85818b636d3437b3702d86dabf8af90a065a973 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:00:54 +0200 Subject: [PATCH 07/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Enhance=20outpu?= =?UTF-8?q?t=20formatting=20by=20adding=20group=20markers=20for=20command?= =?UTF-8?q?=20processing=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 63dd813..30cc97e 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -52,7 +52,7 @@ # Get all exported commands from the module $commands = $moduleInfo.ExportedCommands.Values | Where-Object { $_.CommandType -ne 'Alias' } - Write-Host "Found $($commands.Count) commands to process" + Write-Host "::group::Found $($commands.Count) commands to process" foreach ($command in $commands) { try { @@ -75,7 +75,6 @@ Write-Host '::group::Build docs - Generated files' Get-ChildItem -Path $docsOutputFolder -Recurse | Select-Object -ExpandProperty FullName - Write-Host '::endgroup::' Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { $fileName = $_.Name From ef95348b840d8e9ae928baf2ab052ca605fe2679 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:10:38 +0200 Subject: [PATCH 08/13] Update scripts/helpers/Build-PSModuleDocumentation.ps1 Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 30cc97e..410896a 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -139,7 +139,7 @@ $content | Set-Content -Path $_.FullName } - Write-Host '::group::Build docs - Move markdown files from source files to docs' + Write-Host '::group::Build docs - Move markdown files from public functions folder to docs output folder' Get-ChildItem -Path $PublicFunctionsFolder -Recurse -Force -Include '*.md' | ForEach-Object { $file = $_ $relPath = [System.IO.Path]::GetRelativePath($PublicFunctionsFolder.FullName, $file.FullName) From 426060759ed0ac70a0c6f1a977d8afa7c2d34e4d Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:14:15 +0200 Subject: [PATCH 09/13] Update scripts/helpers/Build-PSModuleDocumentation.ps1 Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 410896a..a6d8c93 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -47,7 +47,7 @@ Write-Host '::group::Build docs - Generate markdown help - Raw' Install-PSModule -Path $ModuleOutputFolder - $moduleInfo = Import-Module -Name $ModuleName -PassThru -Verbose:$false + $moduleInfo = Import-Module -Name $ModuleName -PassThru -Verbose:$false -Force # Get all exported commands from the module $commands = $moduleInfo.ExportedCommands.Values | Where-Object { $_.CommandType -ne 'Alias' } From e9eafda3ce7b18ac6795e52a6ecc13e6c345bdf7 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:19:50 +0200 Subject: [PATCH 10/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Update=20output?= =?UTF-8?q?=20messages=20for=20clarity=20in=20command=20processing=20and?= =?UTF-8?q?=20file=20listing=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 30cc97e..f1fb2df 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -52,8 +52,7 @@ # Get all exported commands from the module $commands = $moduleInfo.ExportedCommands.Values | Where-Object { $_.CommandType -ne 'Alias' } - Write-Host "::group::Found $($commands.Count) commands to process" - + Write-Host "::group::Build docs - Generating markdown help files for $($commands.Count) commands in [$docsOutputFolder]" foreach ($command in $commands) { try { Write-Host "$($command.Name)" -NoNewline @@ -155,8 +154,8 @@ Write-Host '────────────────────────────────────────────────────────────────────────────────' Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { - $fileName = $_.Name - Write-Host "::group:: - [$fileName]" + $relPath = [System.IO.Path]::GetRelativePath($docsOutputFolder, $_.FullName) + Write-Host "::group:: - [$relPath]" Show-FileContent -Path $_ } } From 2efb31ea07a7ca1236a1962472b270869f6decb9 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:31:04 +0200 Subject: [PATCH 11/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Sort=20markdown?= =?UTF-8?q?=20files=20by=20name=20before=20displaying=20in=20Build-PSModul?= =?UTF-8?q?eDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 89ec984..93a75bf 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -153,7 +153,7 @@ } Write-Host '────────────────────────────────────────────────────────────────────────────────' - Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | Sort-Object FullName | ForEach-Object { $relPath = [System.IO.Path]::GetRelativePath($docsOutputFolder, $_.FullName) Write-Host "::group:: - [$relPath]" Show-FileContent -Path $_ From e7afed1c721d59e0d688fff9e87c0a2d563cdd39 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:31:36 +0200 Subject: [PATCH 12/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Add=20end=20gro?= =?UTF-8?q?up=20marker=20in=20Build-PSModuleDocumentation=20for=20better?= =?UTF-8?q?=20output=20organization?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index 93a75bf..b64224d 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -151,7 +151,8 @@ $null = New-Item -Path $docsFolderPath -ItemType Directory -Force Move-Item -Path $file.FullName -Destination $docsFilePath -Force } - + Write-Host "::endgroup::" + Write-Host '────────────────────────────────────────────────────────────────────────────────' Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | Sort-Object FullName | ForEach-Object { $relPath = [System.IO.Path]::GetRelativePath($docsOutputFolder, $_.FullName) From e6d2caaa4404e83163592aafbd5f6c3e213d6810 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Oct 2025 13:33:02 +0200 Subject: [PATCH 13/13] =?UTF-8?q?=F0=9F=A9=B9=20[Patch]:=20Improve=20markd?= =?UTF-8?q?own=20file=20output=20by=20sorting=20and=20displaying=20relativ?= =?UTF-8?q?e=20paths=20in=20Build-PSModuleDocumentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- scripts/helpers/Build-PSModuleDocumentation.ps1 | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/scripts/helpers/Build-PSModuleDocumentation.ps1 b/scripts/helpers/Build-PSModuleDocumentation.ps1 index b64224d..1b33e3b 100644 --- a/scripts/helpers/Build-PSModuleDocumentation.ps1 +++ b/scripts/helpers/Build-PSModuleDocumentation.ps1 @@ -75,9 +75,9 @@ Write-Host '::group::Build docs - Generated files' Get-ChildItem -Path $docsOutputFolder -Recurse | Select-Object -ExpandProperty FullName - Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | ForEach-Object { - $fileName = $_.Name - Write-Host "::group:: - [$fileName]" + Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | Sort-Object FullName | ForEach-Object { + $relPath = [System.IO.Path]::GetRelativePath($docsOutputFolder, $_.FullName) + Write-Host "::group:: - [$relPath]" Show-FileContent -Path $_ } @@ -151,8 +151,8 @@ $null = New-Item -Path $docsFolderPath -ItemType Directory -Force Move-Item -Path $file.FullName -Destination $docsFilePath -Force } - Write-Host "::endgroup::" - + Write-Host '::endgroup::' + Write-Host '────────────────────────────────────────────────────────────────────────────────' Get-ChildItem -Path $docsOutputFolder -Recurse -Force -Include '*.md' | Sort-Object FullName | ForEach-Object { $relPath = [System.IO.Path]::GetRelativePath($docsOutputFolder, $_.FullName)