Skip to content

Conversation

@chaitanyamedidar
Copy link
Contributor

Fixes #281997

Description

This PR updates the description for the swipeToNavigate setting to strictly follow the macOS System Preferences hierarchy.

Previously, the description implied "More Gestures" was the setting itself. This change clarifies that users must navigate into the "Swipe between pages" dropdown located within the "More Gestures" tab.

Formatting Decisions

I chose the format:
...More Gestures > 'Swipe between pages' must be...

Instead of:
...More Gestures "Swipe between pages" must be...

Reasons:

  1. Hierarchy (>): The arrow explicitly denotes navigation depth/hierarchy, separating the Tab from the Setting. Without the arrow, the phrase reads disjointedly.
  2. Code Cleanliness (Single Quotes): Using single quotes (') avoids the need for backslash escapes (\") inside the double-quoted JSON string, keeping the source code cleaner.
  3. Consistency: This matches the styling used later in the same sentence for the value 'Swipe with two or three fingers'.

How to Test

  1. Open VS Code.
  2. Go to Settings (Cmd+,).
  3. Search for swipe to navigate.
  4. Verify the description text now reads:

    "Navigate between open files using three-finger swipe horizontally. Note that System Preferences > Trackpad > More Gestures > 'Swipe between pages' must be set to 'Swipe with two or three fingers'."

Copilot AI review requested due to automatic review settings December 9, 2025 14:19
@chaitanyamedidar
Copy link
Contributor Author

@bpasero Please review the following approach, thank you.

@bpasero bpasero self-assigned this Dec 9, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the user-facing description of the workbench.editor.swipeToNavigate setting by clarifying the exact macOS System Preferences path users need to configure. The previous description was ambiguous about which specific setting within "More Gestures" needed to be changed, potentially causing user confusion.

Key Changes

  • Added "Swipe between pages" to the system preferences path to explicitly identify the dropdown option users must configure
  • Used the > hierarchy separator and single quotes to clearly denote navigation depth and UI element names
  • Maintained consistency with existing formatting patterns in the same description

@chaitanyamedidar chaitanyamedidar marked this pull request as ready for review December 9, 2025 18:46
@vs-code-engineering
Copy link

📬 CODENOTIFY

The following users are being notified based on files changed in this PR:

@bpasero

Matched files:

  • src/vs/workbench/browser/workbench.contribution.ts

@bpasero bpasero added this to the December / January 2026 milestone Dec 10, 2025
@bpasero bpasero enabled auto-merge (squash) December 10, 2025 08:35
@bpasero bpasero merged commit bfdb803 into microsoft:main Dec 10, 2025
17 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.

Swipe to navigate setting missing description

4 participants