Skip to content

Refresh the tutorial output blocks against 6.1.0 - #466

Open
nohwnd wants to merge 1 commit into
nohwnd-tutorial-wrong-statementsfrom
nohwnd-tutorial-refresh-output
Open

Refresh the tutorial output blocks against 6.1.0#466
nohwnd wants to merge 1 commit into
nohwnd-tutorial-wrong-statementsfrom
nohwnd-tutorial-refresh-output

Conversation

@nohwnd

@nohwnd nohwnd commented Aug 29, 2026

Copy link
Copy Markdown
Member

Fix #461

Stacked on #465, which is stacked on #464. Review those first.

The output blocks were captured on 6.0.0. Three things changed in 6.1.0 and they show up in nearly every block, so a reader diffs their terminal against ours and it does not match. That is worst on the prerequisites page, which exists to make them confident the setup is right.

Every Normal verbosity file line now carries a test count. Real run:

[+] .../Planetarium/Private/ConvertTo-AstronomicalUnit.Tests.ps1 183ms (3 tests)
[+] .../Planetarium/Private/Test-PlanetName.Tests.ps1 40ms (4 tests)
[+] .../Planetarium/Public/Get-Planet.Tests.ps1 30ms (5 tests)
[+] .../Planetarium/Public/Get-PlanetDistance.Tests.ps1 25ms (3 tests)

Coverage prints a line between the two we showed:

Processing code coverage result.
Code Coverage result processed in 96ms.
Covered 100% / 75%. 36 analyzed Commands in 7 Files.

The Detailed header is Pester v6.1.0, and Import-Module -PassThru has an ExportedCommands column. I also added a sentence saying a narrow terminal prints that as a list, because it looks nothing like the table and it is the first output anybody compares.

Two claims on the output page while I was there. TestResult.OutputFormat has four values and we listed three, NUnit2.5 was missing. Output.Verbosity also accepts Minimal, which is silently normalized to Normal, so somebody who tries it gets no error and no effect.

Verification

Counts and strings taken from a real run of the finished tutorial suite on pwsh 7.5.5 with Pester 6.1.0, not transcribed by hand. Site builds.

🤖

The blocks were captured on 6.0.0 and we ship 6.1.0, so a reader compares their
terminal against ours and it does not match. Three differences, and they are in
almost every block.

Normal verbosity file lines carry a test count now, "(3 tests)". Coverage prints
"Code Coverage result processed in 96ms." between the two lines we showed. The
Detailed header says v6.1.0, and Import-Module -PassThru has an
ExportedCommands column.

Also two claims on the output page. TestResult.OutputFormat has four values, not
three, NUnit2.5 was missing. Output.Verbosity accepts Minimal as well, it just
behaves as Normal.

Fix #461
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant