polish

Author: aeschli

release-notes/v1_100.md

@@ -136,17 +136,17 @@ We've implemented support for OpenAI's apply patch editing format when using GPT
 
 If a file edit in agent mode introduces new errors, agent mode can now detect them and automatically propose a followup edit. You can disable this behavior with `setting(github.copilot.chat.agent.autoFix)`.
 
-### Prompt and instruction files
+### Prompt and instructions files
 
-We now distinguish between 'instructions' and 'prompt' files, each with their own file suffix and features. The purpose of the separation is to align with the existing custom instructions feature, clarify the purposes and make the UI more intuitive.
+We now distinguish between 'instructions' and 'prompt' files. They use the same fiele format but have separate file suffices and features. The purpose of the separation is to align with the existing custom instructions feature and make the UI more intuitive.
 
-**Instruction files** (aka custom instructions, rule files) provide context to a request, typically describing code guidelines or specifying which framework to use.
+**Instruction files** (aka custom instructions, rules) provide context to a request, typically describing code guidelines or specifying which framework to use.
 
-Instruction files use the `.instructions.md` file suffix. They can be located in your user data folder or in the workspace. The `setting(chat.instructionsFilesLocations)` setting lists the folder where instruction file are searched for.
+Instruction files use the `.instructions.md` file suffix. They can be located in your user data folder or in the workspace. The `setting(chat.instructionsFilesLocations)` setting lists the folders that contain the instruction files.
 
 Instructions files can be added manually or automatically to chat requests.
-- To add them manually, use the `Add Context ` button in the chat view and select `Instructions...`. Alternativly use the  `Chat: Attach Instructions File...` command from the command palette. Then select the instructions file to attach.
-- To have them added automatically, add the `applyTo` header to the instructions file. If a chat request contains a file that matches the given pattern, the instructions file will also be attached.
+- To add them manually, use the `Add Context ` button in the chat view and select `Instructions...`. Alternativly use the `Chat: Attach Instructions File...` command from the command palette. This brings aup a picker that lets you select existing instructions files or create a new one to attach.
+- To have them added automatically, add the `applyTo` header to the instructions file. If a chat request contains a file that matches the given pattern, the instructions file will be attached.
 ````md
 ---
 applyTo: '**/*.ts'
@@ -165,11 +165,11 @@ else
 
 **Prompt files** describe a complete chat request, including the user query, mode and tools to use.
 
-Prompt files use the `.prompt.md` file suffix. They can be located in your user data folder or in the workspace. The `setting(chat.promptFilesLocations)` setting lists the folder where prompt file are searched for.
+Prompt files use the `.prompt.md` file suffix. They can be located in your user data folder or in the workspace. The `setting(chat.promptFilesLocations)` setting lists the folder where prompt files are looked for.
 
 
 To run a prompt file, you can
-- type `/` in the chat input field and select your prompt
+- type `/` in the chat input field and select your prompt file
 ![Run prompt as slash command](images/1_100/run-prompt-as-slash-command.png)
 - open the prompt file in an editor and press the 'Play' button in the editor tool bar
 ![Run prompt as slash command](images/1_100/run-prompt-from-play-button.png)