Only show the folding controls when the mouse is over the gutter.

That does not accord with behaviour. Expand (">") is shown regardless.

I'm guessing that behaviour is a bug, but have held off reporting it until I understand this muddled area more e.g. why there's second expand button at the line end ("...") - with no corresponding collapse button.

Meanwhile I'm pointing this out in case you, like I, think it better for the labelling to accord with erroneos behavior meanwhile.

Only show the folding controls when the mouse is over the gutter.

That does not accord with behaviour. Expand (">") is shown regardless.

@chrisjj good point. I suggest "Hide 'Fold' controls unless the mouse is over the gutter. 'Unfold' controls are always shown."

My suggestion avoids using 'expand' and 'collapse' because those would be inconsistent with documentation and command names.

I suggest "Hide 'Fold' controls unless the mouse is over the gutter. 'Unfold' controls are always shown."

In this context, Fold for Collapse is very ambiguous. And control is needlessly unspecific.

I suggest:

Hide Collapse buttons unless the mouse pointer is over the gutter. Expand buttons are always shown.

The name of the setting itself refers to them as controls. Nor do they have the conventional appearance of buttons. Indeed there are two distinct forms of the Unfold controls, one being the > chevron and the other the end-of-line ellipsis.

I disagree about the ambiguity of Fold in this context, since it contrasts with Unfold in the second sentence. Also, Fold and Unfold are the standard terms in VS Code documentation and the command names.

The name of the setting itself refers to them as controls.

Hardly an authority, right? :).

Nor do they have the conventional appearance of buttons.

Only because the border shown in the docs has been removed for some reason.

However, that doesn't change the fact they are buttons.

I disagree about the ambiguity of Fold in this context, since it contrasts with Unfold in the second sentence.

OK, so your "@chrisjj good point." above is cancelled, right? Because your 'folding' there was excluing my Expand.

Also, Fold and Unfold are the standard terms in VS Code documentation

... relying on expand and collapse for clarification :) e.g.

"Fold (Ctrl+Shift+[) folds the innermost uncollapsed region at the cursor."

Sorry for the inconsistency of terms.

• In the UI it's always fold / unfold.
• The folding controls are also called folding actions in the doc. I will change it there. Better be consistent.

Thanks @gjsjohnmurray !

The folding controls are also called folding actions in the doc.

Where please? I don't see that in https://code.visualstudio.com/docs/editor/codebasics Folding.

Sorry, folding icons.

Thanks. I agree that folding controls is better than folding icons. Though still I think folding buttons is best :)