Skip to content

Conversation

@learn-build-service-prod
Copy link
Contributor

This PR was automatically created by Auto Publish system to publish changes from the main branch to the live branch.

surfingoldelephant and others added 3 commits January 2, 2026 14:32
* Clarify experimental feature is mainstream

Previous verbiage in about_Pipelines wasn't clear that
PSNativeCommandPreserveBytePipe is mainstream in PS 7.4.

* Fix wrong feature link in 7.4 release notes

PSNativeCommandPreserveBytePipe was using the wrong link reference
(10 rather than 11).

The linked doc has also been changed to `about_Pipelines`, as this
explicitly mentions the (now mainstream) feature by name.

* Apply suggestions from review

---------

Co-authored-by: Mikey Lombardi (He/Him) <michael.t.lombardi@gmail.com>
* Fix 5.1 about_Format.ps1xml examples

This fixes the wrong path used in both `Update-FormatData` examples.

The paths used to initially create the custom formatting files are
.\MyDotNetTypes.Format.ps1xml and .\MyFileSystem.Format.ps1xml.

Before this change, Update-FormatData -PrependPath incorrectly pointed
to $HOME\Format\CultureInfo.Format.ps1xml and
$PSHOME\Format\MyFileSystem.Format.ps1xml.

* Use consistent paths in 7.x about_Format.ps1xml

Both Update-FormatData examples now use the $HOME\Format example path.
This also updates the first example to create the directory before
calling Export-FormatData, as the directory doesn't exist by default
and Export-FormatData fails if part of the path is missing.

* Minor style changes

* Specify the correct formatting file extension

This fixes the incorrect assertion that formatting files **must** use
`.format.ps1xml` (only `.ps1xml` is required).

* Adjust formatting file signing note

The original note suggests that after copying Win PS formatting
files, the signature block should be replaced. However, the files don't
actually contain a signature block to begin with. This may cause
confusion, so the note is updated with a more generalized suggestion on
signing taken from about_Format.ps1xml.

Also includes minor style changes and less Windows-specific references.

* Use the same example path in all doc versions

The 7.x docs use `$HOME\Format` as an example directory. This updates
the 5.1 doc to use the same path.

It also removes the suggestion to place custom formatting files in Win
PS's `$PSHOME`. As this is a system directory, it's not an appropriate
location for user files.

* Fix formatting

* Fix link references

* Fix link references again

* Apply suggestions from review

---------

Co-authored-by: Mikey Lombardi (He/Him) <michael.t.lombardi@gmail.com>
* Update CSV cmdlet -Delimiter param description

This clarifies the deserialization behavior when the specified
delimiter doesn't match the actual delimiter in the input data.
Before this change, the verbiage for Import/ConvertFrom-Csv implied
one or more strings would be returned, which isn't the case.

This also adds the existing note regarding escaped special characters
to all docs. Previously, this was only present in Import-Csv docs,
but is applicable to/useful for all CSV cmdlets.

* Apply suggestions from review

---------

Co-authored-by: Mikey Lombardi (He/Him) <michael.t.lombardi@gmail.com>
@learn-build-service-prod
Copy link
Contributor Author

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Contributor Author

Learn Build status updates of commit 0a55ed6:

✅ Validation status: passed

File Status Preview URL Details
reference/5.1/Microsoft.PowerShell.Core/About/about_Format.ps1xml.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-5.1)
reference/5.1/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-5.1)
reference/7.4/Microsoft.PowerShell.Core/About/about_Format.ps1xml.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Core/About/about_Pipelines.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.4/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-7.4)
reference/7.5/Microsoft.PowerShell.Core/About/about_Format.ps1xml.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Core/About/about_Pipelines.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.5/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-7.5)
reference/7.6/Microsoft.PowerShell.Core/About/about_Format.ps1xml.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Core/About/about_Pipelines.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/ConvertFrom-Csv.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/ConvertTo-Csv.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/Export-Csv.md ✅Succeeded View (powershell-7.6)
reference/7.6/Microsoft.PowerShell.Utility/Import-Csv.md ✅Succeeded View (powershell-7.6)
reference/docs-conceptual/developer/format/how-to-create-a-formatting-file-format-ps1xml.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/whats-new/What-s-New-in-PowerShell-74.md ✅Succeeded View (>=powershell-5.1)

For more details, please refer to the build report.

@learn-build-service-prod learn-build-service-prod bot merged commit 9c85e2c into live Jan 2, 2026
15 of 16 checks passed
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.

2 participants