René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Indentation for lines after a pipe character","articleBody":"When we have multiple commands, each piping their output to one another, for readability / single-line width it's generally best to put each command on a different line; like so:\r\n\r\n```powershell\r\nWrite-Verbose 'Before the stuff in the piped code'\r\n$myArrayOfThings |\r\n    Where-Object {$_.SomeText -like 'pattern*'} |\r\n    ForEach-Object {[PSCustomObject]@{\r\n        MyText = $_.SomeText -replace '^pattern', ''\r\n        AnotherProperty = $_.SomethingElse\r\n    }}\r\nWrite-Verbose 'No longer in the piped code'\r\n```\r\n\r\nShould we define a best practice / guideline for this scenario?\r\n\r\nGenerally I indent all lines after the initial pipe to show they're a continuation of the  previous line.  However I don't indent again after subsequent lines because there would be no additional benefit.\r\n\r\nThe downside with this approach is that there's no \"closing line\"; which looks nasty if you the following line is a close for a parent block; e.g. \r\n\r\n```powershell\r\nif ($someFlag) {\r\n    $myArrayOfThings |\r\n        Where-Object {$_.SomeText -like 'pattern*'} |\r\n        ForEach-Object {[PSCustomObject]@{\r\n            MyText = $_.SomeText -replace '^pattern', ''\r\n            AnotherProperty = $_.SomethingElse\r\n        }}\r\n} # here we 're now have 8 spaces between this line's indentation level and the preceding line's.\r\n```\r\n\r\nAn option to tidy this up could be to put a comment to represent the close of he piped \"block\" / maybe with something after the comment character to show it's a close for the piped input; e.g.\r\n\r\n```powershell\r\nif ($someFlag) {\r\n    $myArrayOfThings |\r\n        Where-Object {$_.SomeText -like 'pattern*'} |\r\n        ForEach-Object {[PSCustomObject]@{\r\n            MyText = $_.SomeText -replace '^pattern', ''\r\n            AnotherProperty = $_.SomethingElse\r\n        }}\r\n    # |\r\n}\r\n```\r\n\r\nAnother option could be to put parentheses around the block.\r\n\r\n\r\n```powershell\r\nif ($someFlag) {\r\n    ($myArrayOfThings |\r\n        Where-Object {$_.SomeText -like 'pattern*'} |\r\n        ForEach-Object {[PSCustomObject]@{\r\n            MyText = $_.SomeText -replace '^pattern', ''\r\n            AnotherProperty = $_.SomethingElse\r\n        }}\r\n    )\r\n}\r\n```\r\n\r\n\r\nDo others have any thoughts or preferences on how best to approach these scenarios?","author":{"url":"https://github.com/JohnLBevan","@type":"Person","name":"JohnLBevan"},"datePublished":"2023-10-23T14:12:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/184/PowerShellPracticeAndStyle/issues/184"}