Merge branch 'main' into repo-sync

Author: Octomerger

assets/images/help/codespaces/vscode-change-machine-choose-repo.png

@@ -45,6 +45,30 @@ After you connect your {% data variables.product.product_name %} account to the
 3. Click the Connect to Codespace icon.
  ![The Connect to Codespace icon in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png)
 
+### Changing the machine type in {% data variables.product.prodname_vscode %}
+
+You can run your codespace on a choice of three types of machine: Basic, Standard, or Premium. Each of these has a different level of resources and a different billing tier. 
+
+{% note %}
+
+**Note:** {% data reusables.codespaces.about-billing-for-codespaces %}
+
+{% endnote %}
+
+{% data reusables.codespaces.codespaces-machine-types %}
+
+You can change the machine type of your codespace at any time.
+
+1. In {% data variables.product.prodname_vscode %}, open the Command Palette (`shift command P` / `shift control P`).
+2. Search for and select "Codespaces: Change Machine Type."
+![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-type-option.png)
+3. Click the codespace that you want to change.
+![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-choose-repo.png)
+4. Choose the machine type you want to use. 
+![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-choose-type.png)
+
+If the codespace is currently running, a message is displayed asking if you would like to restart and reconnect to your codespace now. Click **Yes** if you want to change the machine type used for this codespace immediately. If you click **No**, or if the codespace is not currently running, the change will take effect the next time the codespace restarts.
+
 ### Deleting a codespace in {% data variables.product.prodname_vscode %}
 
 1. Under "Codespaces", right-click the codespace you want to delete.

assets/images/help/codespaces/vscode-change-machine-choose-type.png

@@ -0,0 +1,5 @@
+Being able to switch machine types gives you the flexibility you need to choose appropriate resources to fit the work you are doing. As a guide, you might choose different machine types for these tasks:
+
+* **Basic** for updating a file and raising a pull request
+* **Standard** for editing a website
+* **Premium** for high compute tasks such as data analysis