From 4ef8f3da2b20a09e8f2b6e41dc7be282dbb6d43c Mon Sep 17 00:00:00 2001
From: Clint Rutkas <clint@rutkas.com>
Date: Fri, 31 Jan 2020 18:17:07 -0800
Subject: [PATCH] Update README.md (#1198)

---
 installer/README.md | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/installer/README.md b/installer/README.md
index a3d400688..a94dfbff9 100644
--- a/installer/README.md
+++ b/installer/README.md
@@ -1,30 +1,30 @@
-# PowerToys Setup Project
+# PowerToys MSIX installer instructions
 
-## MSIX instructions
+## One-time tasks
 
-### 1-time Run
-
-#### Create Self-sign certificate
+### Create and install the self-sign certificate
 For the first-time installation, you'll need to generate a self-signed certificate.  The script below will generate and add a cert to your [TRCA store](https://docs.microsoft.com/en-us/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store). 
 1. Open `Developer PowerShell for VS` as an Admin
 2. Navigate to your repo's `installer\MSIX`
 3. Run `.\generate_self_sign_cert.ps1`
 
-#### Elevate `Developer PowerShell for VS` permissions
+**Note:** if you delete the folder, you will have to regenerate the key
+
+### Elevate `Developer PowerShell for VS` permissions due to unsigned file
 `msix_reinstall.ps1` is unsigned, you'll need to elevate your prompt.
 1. Open `Developer PowerShell for VS` as admin
 2. Run `Set-ExecutionPolicy -executionPolicy Unrestricted`
 
-### To Build MSIX
+## To Build MSIX
 1. Make sure you've built the `Release` configuration of `powertoys.sln`
 2. Open `Developer PowerShell for VS`
 3. Navigate to your repo's `installer\MSIX`
 4. Run `.\msix_reinstall.ps1` from the devenv powershell
 
-#### What msix_reinstall.ps1 does
+### What msix_reinstall.ps1 does
 `msix_reinstall.ps1` removes the current PowerToys installation, restarts explorer.exe (to update PowerRename shell extension), builds `PowerToys-x64.msix` package, signs it with a PowerToys_TemporaryKey.pfx, and finally installs it.
 
-#### Removing all .msi/.msix PowerToys installations
+### Removing all .msi/.msix PowerToys installations
 ```ps
 $name='PowerToys'
 Get-AppxPackage -Name $name | select -ExpandProperty "PackageFullName" | Remove-AppxPackage
@@ -34,8 +34,8 @@ gwmi win32_product -filter "Name = '$name'" -namespace root/cimv2 | foreach {
 }
 ```
 
-## MSI Build instructions (Deprecated)
-  * Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset).
-  * Install the [WiX Toolset build tools](https://wixtoolset.org/releases/) in the development machine.
-  * Open `powertoys.sln`, select the "Release" and "x64" configurations and build the `PowerToysSetup` project.
-  * The resulting installer will be built to `PowerToysSetup\bin\Release\PowerToysSetup.msi`.
+# MSI Build instructions (Deprecated)
+1. Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset).
+2. Install the [WiX Toolset build tools](https://wixtoolset.org/releases/) in the development machine.
+3. Open `powertoys.sln`, select the "Release" and "x64" configurations and build the `PowerToysSetup` project.
+4. The resulting installer will be built to `PowerToysSetup\bin\Release\PowerToysSetup.msi`.