From 7f5cfaa12bef1c4134e9dce71b8d93b81ca72681 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Edu=20G=C3=B3mez=20Escandell?=
 <edu.gomez.escandell@canonical.com>
Date: Mon, 11 Dec 2023 09:58:16 +0100
Subject: [PATCH 1/2] Remove "How to" from the table of contents

This makes the ToC more readable.
---
 docs/index.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 3a2415973..8df8b94f7 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -18,11 +18,11 @@ Thinking about using Ubuntu Pro for Windows for your next project? Get in touch!
 ```{toctree}
 :hidden:
  
-How to install Ubuntu Pro for Windows <02-install>
-How to restart Ubuntu Pro For Windows <03-restart>
-How to auto-attach distros to Ubuntu Pro <04-enable-pro>
-How to auto-register distros to Landscape <05-attach-landscape>
-How to access the logs <06-access-the-logs.md>
+Install Ubuntu Pro for Windows <02-install>
+Restart Ubuntu Pro For Windows <03-restart>
+Auto-attach distros to Ubuntu Pro <04-enable-pro>
+Auto-register distros to Landscape <05-attach-landscape>
+Access the logs <06-access-the-logs.md>
 Windows Agent command line interface <07-windows-agent-command-line-reference>
 WSL Pro Service command line interface <08-wsl-pro-service-command-line-reference>
 ```

From bd8d76e97528be0ff137b2b12c7046400c6260ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Edu=20G=C3=B3mez=20Escandell?=
 <edu.gomez.escandell@canonical.com>
Date: Mon, 11 Dec 2023 16:01:29 +0100
Subject: [PATCH 2/2] Move "how to reinstall" from "restart" to "install"
 sections

This avoids the need for a #title in the restart section, which messed
with the ToC.
---
 docs/02-install.md | 23 ++++++++++++++++++-----
 docs/03-restart.md | 11 -----------
 2 files changed, 18 insertions(+), 16 deletions(-)

diff --git a/docs/02-install.md b/docs/02-install.md
index 7b5e09d05..8e0cb3b30 100644
--- a/docs/02-install.md
+++ b/docs/02-install.md
@@ -2,14 +2,16 @@
 
 This guide will show you how to install Ubuntu Pro For Windows for local development and testing.
 
-## Requirements
+## Install Ubuntu Pro For Windows from scratch
+
+### Requirements
 - A Windows machine with access to the internet
 - Appx from the Microsoft Store:
   - Windows Subsystem For Linux
   - Either Ubuntu, Ubuntu 22.04, or Ubuntu (Preview)
 - The Windows Subsystem for Windows optional feature enabled
 
-## Download
+### Download
 <!-- TODO: Update when we change were artifacts are hosted -->
 1. Go to the [repository actions page](https://github.com/canonical/ubuntu-pro-for-windows/actions/workflows/qa-azure.yaml?query=branch%3Amain+).
 2. Click the latest successful workflow run.
@@ -20,7 +22,7 @@ This guide will show you how to install Ubuntu Pro For Windows for local develop
 
 Notice that, for the step above, there is also an alternative version of the MSIX bundle enabled for end-to-end testing. Most likely, that's not what you want to download.
 
-## Install the Windows agent
+### Install the Windows agent
 This is the Windows-side agent that manages the distros.
 1. Uninstall Ubuntu Pro For Windows if you had installed previously:
     ```powershell
@@ -33,7 +35,7 @@ This is the Windows-side agent that manages the distros.
 6. The Firewall may ask for an exception. Allow it.
 7. The GUI should show up. You’re done.
 
-## Install the WSL Pro Service
+### Install the WSL Pro Service
 This is the Linux-side component that talks to the agent. Choose one or more distros Jammy or greater, and follow the instructions.
 1. Uninstall the WSL-Pro-Service from your distro if you had it installed previously:
     ```bash
@@ -52,4 +54,15 @@ This is the Linux-side component that talks to the agent. Choose one or more dis
 6. Ensure it works via systemd:
     ```bash
     systemctl status wsl-pro.service
-    ```
\ No newline at end of file
+    ```
+
+## Reset Ubuntu Pro for Windows back to factory settings
+You can reset Ubuntu Pro For Windows to factory settings following these steps:
+1. Uninstall the package and shut down WSL:
+    ```powershell
+    Get-AppxPackage -Name "CanonicalGroupLimited.UbuntuProForWindows" | Remove-AppxPackage`
+    wsl --shutdown
+    ```
+2. Remove registry key `HKEY_CURRENT_USER\Software\Canonical\UbuntuPro`.
+3. Install the package again (see the section on [how to install](./02-install.md)).
+4. You're done. Next time you start the GUI it'll be like a fresh install.
diff --git a/docs/03-restart.md b/docs/03-restart.md
index 906432749..56aa49a01 100644
--- a/docs/03-restart.md
+++ b/docs/03-restart.md
@@ -24,14 +24,3 @@ This is the simple one. If you're not in a hurry to see the configuration update
     3. Wait a minute.
     4. Click on "Click to restart it".
 8.  Start the distro, or distros you installed WSL-Pro-Service in.
-
-# How to reset Ubuntu Pro for Windows back to factory settings
-You can reset Ubuntu Pro For Windows to factory settings following these steps:
-1. Uninstall the package and shut down WSL:
-    ```powershell
-    Get-AppxPackage -Name "CanonicalGroupLimited.UbuntuProForWindows" | Remove-AppxPackage`
-    wsl --shutdown
-    ```
-2. Remove registry key `HKEY_CURRENT_USER\Software\Canonical\UbuntuPro`.
-3. Install the package again (see the section on [how to install](./02-install.md)).
-4. You're done. Next time you start the GUI it'll be like a fresh install.