PowerShell / PowerShell/vscode-powershell

Can we get back folding on help sections?

Open
#3,028 3 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Area-Folding Issue-Enhancement
Dominant language
TypeScript
Stars
1.9k
Forks
547
PR merge metrics
No merged PRs in 30d

Description

Ever since the "syntax based" code folding was introduced
image

The documentation sections won't fold the way they used to:
image

Because the whole comment block is one big blob:
image

Can we add support for the comment-based help documentation keywords to fold the help below them?

P.S. When I turn that setting off, it completely kills folding for PowerShell files until I kill the integrated terminal.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No file or test is named in the issue. Reproduce the regression with syntax-based folding enabled, compare it with the setting disabled, and inspect the extension's folding support for PowerShell comment-based help keywords; done means help sections fold individually without disabling folding for the rest of the file.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell, typescript, vscode
Domain
developer-experience, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.