Merge pull request microsoft#55609 from Microsoft/octref/setting-desc…

…ription

Settings description update for microsoft#54690

extensions/css-language-features/package.nls.json

@@ -19,7 +19,7 @@
 	"css.lint.unknownAtRules.desc": "Unknown at-rule.",
 	"css.lint.unknownProperties.desc": "Unknown property.",
 	"css.lint.unknownVendorSpecificProperties.desc": "Unknown vendor specific property.",
-	"css.lint.vendorPrefix.desc": "When using a vendor-specific prefix also include the standard property.",
+	"css.lint.vendorPrefix.desc": "When using a vendor-specific prefix, also include the standard property.",
 	"css.lint.zeroUnits.desc": "No unit for zero needed.",
 	"css.trace.server.desc": "Traces the communication between VS Code and the CSS language server.",
 	"css.validate.title": "Controls CSS validation and problem severities.",
@@ -41,7 +41,7 @@
 	"less.lint.universalSelector.desc": "The universal selector (`*`) is known to be slow.",
 	"less.lint.unknownProperties.desc": "Unknown property.",
 	"less.lint.unknownVendorSpecificProperties.desc": "Unknown vendor specific property.",
-	"less.lint.vendorPrefix.desc": "When using a vendor-specific prefix also include the standard property.",
+	"less.lint.vendorPrefix.desc": "When using a vendor-specific prefix, also include the standard property.",
 	"less.lint.zeroUnits.desc": "No unit for zero needed.",
 	"less.validate.title": "Controls LESS validation and problem severities.",
 	"less.validate.desc": "Enables or disables all validations.",
@@ -62,7 +62,7 @@
 	"scss.lint.universalSelector.desc": "The universal selector (`*`) is known to be slow.",
 	"scss.lint.unknownProperties.desc": "Unknown property.",
 	"scss.lint.unknownVendorSpecificProperties.desc": "Unknown vendor specific property.",
-	"scss.lint.vendorPrefix.desc": "When using a vendor-specific prefix also include the standard property.",
+	"scss.lint.vendorPrefix.desc": "When using a vendor-specific prefix, also include the standard property.",
 	"scss.lint.zeroUnits.desc": "No unit for zero needed.",
 	"scss.validate.title": "Controls SCSS validation and problem severities.",
 	"scss.validate.desc": "Enables or disables all validations.",

extensions/git/package.nls.json

@@ -53,9 +53,9 @@
 	"config.enabled": "Whether git is enabled.",
 	"config.path": "Path to the git executable.",
 	"config.autoRepositoryDetection": "Configures when repositories should be automatically detected.",
-	"config.autorefresh": "Whether auto refreshing is enabled",
-	"config.autofetch": "Whether auto fetching is enabled",
-	"config.enableLongCommitWarning": "Whether long commit messages should be warned about",
+	"config.autorefresh": "Whether auto refreshing is enabled.",
+	"config.autofetch": "Whether auto fetching is enabled.",
+	"config.enableLongCommitWarning": "Whether long commit messages should be warned about.",
 	"config.confirmSync": "Confirm before synchronizing git repositories.",
 	"config.countBadge": "Controls the git badge counter.",
 	"config.countBadge.all": "Count all changes.",
@@ -67,8 +67,8 @@
 	"config.checkoutType.tags": "Show only tags.",
 	"config.checkoutType.remote": "Show only remote branches.",
 	"config.ignoreLegacyWarning": "Ignores the legacy Git warning.",
-	"config.ignoreMissingGitWarning": "Ignores the warning when Git is missing",
-	"config.ignoreLimitWarning": "Ignores the warning when there are too many changes in a repository",
+	"config.ignoreMissingGitWarning": "Ignores the warning when Git is missing.",
+	"config.ignoreLimitWarning": "Ignores the warning when there are too many changes in a repository.",
 	"config.defaultCloneDirectory": "The default location to clone a git repository.",
 	"config.enableSmartCommit": "Commit all changes when there are no staged changes.",
 	"config.enableCommitSigning": "Enables commit signing with GPG.",
@@ -81,8 +81,8 @@
 	"config.detectSubmodules": "Controls whether to automatically detect git submodules.",
 	"colors.added": "Color for added resources.",
 	"config.detectSubmodulesLimit": "Controls the limit of git submodules detected.",
-	"config.alwaysSignOff": "Controls the signoff flag for all commits",
-	"config.ignoredRepositories": "List of git repositories to ignore",
+	"config.alwaysSignOff": "Controls the signoff flag for all commits.",
+	"config.ignoredRepositories": "List of git repositories to ignore.",
 	"colors.modified": "Color for modified resources.",
 	"colors.deleted": "Color for deleted resources.",
 	"colors.untracked": "Color for untracked resources.",

extensions/npm/package.nls.json

@@ -6,7 +6,7 @@
 	"config.npm.packageManager": "The package manager used to run scripts.",
 	"config.npm.exclude": "Configure glob patterns for folders that should be excluded from automatic script detection.",
 	"config.npm.enableScriptExplorer": "Enable an explorer view for npm scripts.",
-	"config.npm.scriptExplorerAction": "The default click action used in the scripts explorer: 'open' or 'run', the default is 'open'.",
+	"config.npm.scriptExplorerAction": "The default click action used in the scripts explorer: `open` or `run`, the default is `open`.",
 	"config.npm.fetchOnlinePackageInfo": "Fetch data from https://registry.npmjs/org and https://registry.bower.io to provide auto-completion and information on hover features on npm dependencies.",
 	"npm.parseError": "Npm task detection: failed to parse the file {0}",
 	"taskdef.script": "The npm script to customize.",

src/vs/editor/common/config/commonEditorConfig.ts

@@ -592,7 +592,7 @@ const editorConfiguration: IConfigurationNode = {
 		'editor.selectionHighlight': {
 			'type': 'boolean',
 			'default': EDITOR_DEFAULTS.contribInfo.selectionHighlight,
-			'description': nls.localize('selectionHighlight', "Controls whether the editor should highlight similar matches to the selection")
+			'description': nls.localize('selectionHighlight', "Controls whether the editor should highlight matches similar to the selection")
 		},
 		'editor.occurrencesHighlight': {
 			'type': 'boolean',

src/vs/workbench/electron-browser/main.contribution.ts

@@ -355,8 +355,10 @@ configurationRegistry.registerConfiguration({
 				nls.localize('workbench.editor.labelFormat.long', "Show the name of the file followed by it's absolute path.")
 			],
 			'default': 'default',
-			'description': nls.localize({ comment: ['This is the description for a setting. Values surrounded by parenthesis are not to be translated.'], key: 'tabDescription' },
-				"Controls the format of the label for an editor. Changing this setting can for example make it easier to understand the location of a file:\n- short:   'parent'\n- medium:  'workspace/src/parent'\n- long:    '/home/user/workspace/src/parent'\n- default: '.../parent', when another tab shares the same title, or the relative workspace path if tabs are disabled"),
+			'description': nls.localize({
+				comment: ['This is the description for a setting. Values surrounded by parenthesis are not to be translated.'],
+				key: 'tabDescription'
+			}, "Controls the format of the label for an editor."),
 		},
 		'workbench.editor.tabCloseButton': {
 			'type': 'string',
@@ -398,13 +400,13 @@ configurationRegistry.registerConfiguration({
 			'type': 'string',
 			'enum': ['left', 'right', 'first', 'last'],
 			'default': 'right',
-			'description': nls.localize({ comment: ['This is the description for a setting. Values surrounded by single quotes are not to be translated.'], key: 'editorOpenPositioning' }, "Controls where editors open. Select 'left' or 'right' to open editors to the left or right of the currently active one. Select 'first' or 'last' to open editors independently from the currently active one.")
+			'description': nls.localize({ comment: ['This is the description for a setting. Values surrounded by single quotes are not to be translated.'], key: 'editorOpenPositioning' }, "Controls where editors open. Select `left` or `right` to open editors to the left or right of the currently active one. Select `first` or `last` to open editors independently from the currently active one.")
 		},
 		'workbench.editor.openSideBySideDirection': {
 			'type': 'string',
 			'enum': ['right', 'down'],
 			'default': 'right',
-			'description': nls.localize('sideBySideDirection', "Controls the default direction of editors that are opened side by side (e.g. from the explorer). By default, editors will open on the right hand side of the currently active one. If changed to open down, the editors will open below the currently active one.")
+			'description': nls.localize('sideBySideDirection', "Controls the default direction of editors that are opened side by side (e.g. from the explorer). By default, editors will open on the right hand side of the currently active one. If changed to `down`, the editors will open below the currently active one.")
 		},
 		'workbench.editor.closeEmptyGroups': {
 			'type': 'boolean',

src/vs/workbench/parts/debug/electron-browser/debug.contribution.ts

@@ -193,7 +193,7 @@ configurationRegistry.registerConfiguration({
 		},
 		'debug.toolBarLocation': {
 			enum: ['floating', 'docked', 'hidden'],
-			description: nls.localize({ comment: ['This is the description for a setting'], key: 'toolBarLocation' }, "Controls the location of the debug toolbar. Either \"floating\" in all views, \"docked\" in the debug view, or \"hidden\""),
+			description: nls.localize({ comment: ['This is the description for a setting'], key: 'toolBarLocation' }, "Controls the location of the debug toolbar. Either `floating` in all views, `docked` in the debug view, or `hidden`"),
 			default: 'floating'
 		},
 		'debug.showInStatusBar': {