Updates

Author: bamurtaugh

blogs/2025/next-edit-suggestions.md

@@ -44,13 +44,15 @@ Suggestions may span a single symbol, an entire line, or multiple lines, dependi
 ## Example scenarios
 Copilot NES is an expert companion as you make changes that may cascade throughout your file or project. The following are a few examples where NES shines.
 
-**Refactoring:** Rename a variable once in a file, and Copilot NES will suggest to update it everywhere else.
+**Changing intent:** Copilot NES suggests changes that match a change in intent. For example, changing a class from `point` to `point3d` will add a `z` variable to the class definition and its distance calculation.
 <!-- TODO: Add image -->
 
-**Correcting mistakes:** Copilot NES helps with mistakes like typos. It can also help with more challenging mistakes in logic, like if a statement should've used `AND` instead of `OR`.
+**Adding new variables or logic:** Copilot NES helps you use new code you just added. This may be a small change, like calling a new method parameter in the actual method. It could also be more complex: if you added a new command to your VS Code extension's `extension.ts`, when you open `package.json`, NES may suggest adding that command as well.
+
+**Refactoring:** Rename a variable once in a file, and Copilot NES will suggest to update it everywhere else.
 <!-- TODO: Add image -->
 
-**Changing intent:** Copilot NES suggests changes that match a change in intent. For example, changing a function `moveCursorUp` to `moveCursorDown` should adjust all the code logically.
+**Correcting mistakes:** Copilot NES helps with mistakes like typos. It can also help with more challenging mistakes in logic, like if a statement should've used `AND` instead of `OR`.
 <!-- TODO: Add image -->
 
 ## Share your feedback

docs/copilot/ai-powered-suggestions.md

@@ -94,24 +94,24 @@ You can hover over the arrow to explore the edit suggestion menu, which includes
 
 <!-- TODO: Polish entire section, add maybe an image per example -->
 
+**Changing intent**
+
+* **Copilot suggests changes to the rest of your code that match a new change in intent.** For example, changing a class from `point` to `point3d` will add a `z` variable to the class definition and its distance calculation.
+
+**Adding new variables or logic**
+
+* **Add an argument, variable, or function**. Copilot NES helps you use new code you just added. This may be a small change, like calling a new method parameter in the actual method. It could also be more complex: if you added a new command to your VS Code extension's `extension.ts`, when you open `package.json`, NES may suggest adding that command as well.
+
 **Refactoring**
 
 * **Rename a variable once in a file, and Copilot will suggest to update it everywhere else.** If you use a new naming pattern (like renaming a variable `index1` to `indexArr1`), Copilot suggests to rename subsequent variables similarly (like updating `index2` to `indexArr2`).
 * **Matching code style**. After copy-pasting some code, Copilot will suggest how to adjust it to match the current code where the paste happened.
 
-**Adding new variables or arguments**
-
-* **Add an argument to a function or a new variable to a class**. Copilot suggests to use those additions as appropriate, such as calling the varaible in the function, or in an upcoming `if` or `switch` statement.
-
 **Correcting mistakes**
 
 * **Copilot helps with mistakes like typos.** It'll suggest fixes where letters are missing or swapped, like `cont x = 5` or `conts x = 5`, which should've been `const x = 5`.
 * **Copilot can also help with mistakes in logic**, like where a statement should've had `<` instead of `<=`, or an `OR` statement that should've been an `AND`.
 
-**Changing intent**
-
-* **Copilot suggests changes to the rest of your code that match a new change in intent.** For instance, changing a function `moveCursorUp` to `moveCursorDown` should adjust all the code logically.
-
 ## Tips & tricks
 
 ### Context