reformat and standardize comment based help in powershell

format-cbh.ps1

function Get-Header ($text) {
    $start = $text.IndexOf('<#')
    $text.SubString(0, $start - 2)
}

function Format-Help ($text) {
    $start = $text.IndexOf('<#')
    $end = $text.IndexOf('#>')
    $help = $text.SubString($start + 2, $end - $start - 2)
    
    $skipfirst = $null # to avoid trailing spaces
    foreach ($newline in $help.Split("`n")) {
        if (-not $skipfirst) { $skipfirst = $true; continue }
        $trimmed = $newline.Trim()
        foreach ($line in $trimmed) {
            if ($line.StartsWith(".")) {
                "    $line"
            }
            else {
                "        $line"
            }
        }
    }
}

function Get-Body ($text) {
    $end = $text.IndexOf('#>')
    $text.SubString($end, $text.Length - $end)
}

$files = Get-ChildItem -Recurse C:\github\dbatools\functions\*.ps1

foreach ($file in $files) {
    $text = ($file | Get-Content -Raw).Trim()
    Set-Content -Path $file.FullName -Encoding UTF8 -Value (Get-Header $text).TrimEnd()
    Add-Content -Path $file.FullName -Encoding UTF8 -Value "<#".Trim()
    Add-Content -Path $file.FullName -Encoding UTF8 -Value (Format-Help $text)
    Add-Content -Path $file.FullName -Encoding UTF8 -Value (Get-Body $text).TrimEnd() -NoNewline
}