update docs of the config module, use the current prompt files public feature name

Author: legomushroom

src/vs/platform/prompts/common/config.ts

@@ -3,62 +3,19 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-import { IConfigurationService } from '../../configuration/common/configuration.js';
 import { ContextKeyExpr } from '../../contextkey/common/contextkey.js';
-
-// TODO: @lego - update the docs
-// TODO: @lego - update unit tests
+import { IConfigurationService } from '../../configuration/common/configuration.js';
 
 /**
  * Configuration helper for the `reusable prompts` feature.
  * @see {@link CONFIG_KEY} and {@link LOCATIONS_CONFIG_KEY}.
  *
  * ### Functions
  *
- * - {@link getLocationsValue} allows to current read configuration value
  * - {@link enabled} allows to check if the feature is enabled
+ * - {@link getLocationsValue} allows to current read configuration value
  * - {@link promptSourceFolders} gets list of source folders for prompt files
  *
- * ### Configuration Examples
- *
- * Enable the feature using the default `'.github/prompts'` folder as a source of prompt files:
- * ```json
- * {
- *   "chat.promptFiles": {},
- * }
- * ```
- *
- * Enable the feature, providing multiple source folder paths for prompt files,
- * in addition to the default `'.github/prompts'` one:
- * ```json
- * {
- *   "chat.promptFiles": {
- *     ".copilot/prompts" : false,
- *     "/Users/legomushroom/repos/prompts" : true,
- *   },
- * }
- * ```
- *
- * See the next section for details on how we treat the config value.
- *
- * ### Possible Values
- *
- * - `undefined`/`null`: feature is disabledx
- * - `object`:
- *   - expects the { "string": `boolean` } pairs, where the `string` is a path and the `boolean`
- *     is a flag that defines if this additional source folder is enabled or disabled;
- *     enabled source folders are used in addition to the default {@link DEFAULT_SOURCE_FOLDER} path;
- *     you can explicitly disable the default source folder by setting it to `false` in the object
- *   - value of a record in the object can also be a `string`:
- *     - if the string can be clearly mapped to a `boolean` (e.g., `"true"`, `"FALSE", "TrUe"`, etc.),
- *       it is treated as `boolean` value
- *     - any other string value is treated as `false` and is effectively ignored
- *   - if the record `key` is an `empty` string, it is ignored
- *   - if the resulting object is empty, the feature is considered `enabled`, prompt files source
- *     folders fallback to the default {@link DEFAULT_SOURCE_FOLDER} path
- *   - if the resulting object is not empty, and the default {@link DEFAULT_SOURCE_FOLDER} path
- *     is not explicitly disabled, it is added to the list of prompt files source folders
- *
  * ### File Paths Resolution
  *
  * We resolve only `*.prompt.md` files inside the resulting source folders. Relative paths are resolved
@@ -74,12 +31,12 @@ export namespace PromptsConfig {
 	 * Configuration key for the `reusable prompts` feature
 	 * (also known as `prompt files`, `prompt instructions`, etc.).
 	 */
-	export const CONFIG_KEY: string = 'chat.reusablePrompts';
+	export const CONFIG_KEY: string = 'chat.promptFiles';
 
 	/**
 	 * Configuration key for the locations of reusable prompt files.
 	 */
-	export const LOCATIONS_CONFIG_KEY: string = 'chat.reusablePromptsLocations';
+	export const LOCATIONS_CONFIG_KEY: string = 'chat.promptFilesLocations';
 
 	/**
 	 * Default reusable prompt files source folder.

src/vs/platform/prompts/test/common/config.test.ts

@@ -34,7 +34,7 @@ const createMock = <T>(value: T): IConfigurationService => {
 suite('PromptsConfig', () => {
 	ensureNoDisposablesAreLeakedInTestSuite();
 
-	suite('• getValue', () => {
+	suite('• getLocationsValue', () => {
 		test('• undefined', () => {
 			const configService = createMock(undefined);
 

src/vs/workbench/contrib/chat/browser/chat.contribution.ts

@@ -203,25 +203,24 @@ configurationRegistry.registerConfiguration({
 			type: 'boolean',
 			title: nls.localize(
 				'chat.reusablePrompts.config.enabled.title',
-				"Reusable Prompts",
+				"Prompt Files",
 			),
 			markdownDescription: nls.localize(
 				'chat.reusablePrompts.config.enabled.description',
-				"Enable reusable prompts (`*{0}`) in Chat, Edits, and Inline Chat sessions. [Learn More]({0}).",
+				"Enable reusable prompt files (`*{0}`) in Chat, Edits, and Inline Chat sessions. [Learn More]({0}).",
 				PROMPT_FILE_EXTENSION,
 				DOCUMENTATION_URL,
 			),
 			default: true,
 			restricted: true,
 			disallowConfigurationDefault: true,
-			tags: ['experimental'],
+			tags: ['experimental', 'prompts', 'reusable prompts', 'prompt snippets', 'instructions'],
 		},
-		// TODO: @lego - add more tags?
 		[PromptsConfig.LOCATIONS_CONFIG_KEY]: {
 			type: 'object',
 			title: nls.localize(
 				'chat.reusablePrompts.config.locations.title',
-				"Reusable Prompt Locations",
+				"Prompt File Locations",
 			),
 			markdownDescription: nls.localize(
 				'chat.reusablePrompts.config.locations.description',
@@ -237,7 +236,7 @@ configurationRegistry.registerConfiguration({
 			unevaluatedProperties: { type: 'boolean' },
 			restricted: true,
 			disallowConfigurationDefault: true,
-			tags: ['experimental'],
+			tags: ['experimental', 'prompts', 'reusable prompts', 'prompt snippets', 'instructions'],
 			examples: [
 				{
 					[PromptsConfig.DEFAULT_SOURCE_FOLDER]: true,