Document how to keep codespaces indefinitely (#34194)

Co-authored-by: github-actions <github-actions@github.com>

content/codespaces/developing-in-codespaces/deleting-a-codespace.md

@@ -15,7 +15,16 @@ topics:
 shortTitle: Delete a codespace
 ---
 
-You can delete a codespace in a variety of ways: in the terminal by using {% data variables.product.prodname_cli %}, in {% data variables.product.prodname_vscode %}, or in your web browser. Use the tabs in this article to display instructions for each of these ways of deleting a codespace.
+## Overview
+
+{% data reusables.codespaces.automatic-deletion %} For more information, see "[Configuring automatic deletion of your codespaces](http://127.0.0.1:4000/en/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces?tool=webui)."
+
+You can manually delete a codespace in a variety of ways:
+- In the terminal by using {% data variables.product.prodname_cli %}
+- In {% data variables.product.prodname_vscode %}
+- In your web browser
+
+Use the tabs at the top of this article to display instructions for each of these ways of deleting a codespace.
 
 {% note %}
 
@@ -23,6 +32,8 @@ You can delete a codespace in a variety of ways: in the terminal by using {% dat
 
 {% endnote %}
 
+## Why you should delete unused codespaces
+
 There are costs associated with storing codespaces. You should therefore delete any codespaces you no longer need. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
 
 {% data reusables.codespaces.max-number-codespaces %}
@@ -32,9 +43,9 @@ There are costs associated with storing codespaces. You should therefore delete
 {% webui %}
 
 {% data reusables.codespaces.your-codespaces-procedure-step %}
-1. To the right of the codespace you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **{% octicon "trash" aria-label="The trash icon" %} Delete**
+1. To the right of the codespace you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **{% octicon "trash" aria-label="The trash icon" %} Delete**.
 
-   ![Delete button](/assets/images/help/codespaces/delete-codespace.png)
+   ![Screenshot of the 'Delete' button](/assets/images/help/codespaces/delete-codespace.png)
 
 {% endwebui %}
 
@@ -44,7 +55,6 @@ There are costs associated with storing codespaces. You should therefore delete
 
 {% endvscode %}
 
-
 {% cli %}
 
 {% data reusables.cli.cli-learn-more %}
@@ -86,7 +96,7 @@ You can delete several or all of your codespaces with a single command, using `g
 
 `--days NUMBER` - Delete all of your codespaces that are older than the specified number of days. Can be used together with the `--repo` flag.
 
-By default you are prompted to confirm deletion of any codespaces that contain unsaved changes. You can use the `--force` flag to skip this confirmation. 
+By default you are prompted to confirm deletion of any codespaces that contain unsaved changes. You can use the `--force` flag to skip this confirmation.
 
 ### Example
 
@@ -117,7 +127,7 @@ For more information, click the "{% data variables.product.prodname_cli %}" tab
 {% cli %}
 
 1. Enter one of these commands to display a list of codespaces.
-   * `gh codespace delete --org ORGANIZATION` - Lists the current codespaces in the specified organization. 
+   * `gh codespace delete --org ORGANIZATION` - Lists the current codespaces in the specified organization.
    * `gh codespace delete --org ORGANIZATION --user USER` - Lists only those codespaces created by the specified user.
    You must be an owner of the specified organization.
 1. In the list of codespaces, navigate to the codespace you want to delete.
@@ -132,3 +142,4 @@ You can also use the REST API to delete codespaces for your organization. For mo
 ## Further reading
 - "[The codespace lifecycle](/codespaces/getting-started/the-codespace-lifecycle)"
 - "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)"
+- "[Restricting the retention period for codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)"

content/codespaces/developing-in-codespaces/opening-an-existing-codespace.md

@@ -26,6 +26,7 @@ You can view all your codespaces on the "Your codespaces" page at [github.com/co
 - See who owns (and may be billed for) your codespaces: your personal account, or organizations you belong to. For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
 - See the machine type, size, and status of your codespaces.
 - Create a new codespace, either by choosing one of {% data variables.product.company_short %}'s templates or by clicking **New codespace**. For more information, see "[Creating a codespace from a template](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)" and "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)."
+- Prevent automatic deletion of a codespace. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces?tool=webui#avoiding-automatic-deletion-of-codespaces)."
 
 ## Opening an existing codespace