Update `Start-Transcript` use with relative paths

[SteveL-MSFT]

Prerequisites

• Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
• Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Typo in Get-Foo cmdlet" instead of "Typo."
• Verify Version: If there is a mismatch between documentation and the behavior on your system, ensure that the version you are using is the same as the documentation. Check this box if they match or the issue you are reporting is not version specific.

Links

PowerShell/PowerShell#25907
https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.host/start-transcript?view=powershell-7.5#-outputdirectory

Summary

Start-Transcript when using -OutputDirectory if the user specifies a relative path, it is relative to their Documents folder and not the current working directory. The docs should explicitly mention this behavior and also include an example on using Resolve-Path on how to use a relative path with this cmdlet.

Details

No response

Suggested Fix

No response

[sdwheeler]

Resolve-Path errors if the target relative path doesn't exist. We already have an example that uses Join-Path. That should be sufficient. I submitted a PR to update the description of the -OutputDirectory parameter and added examples for using relative paths on Windows and Linux.