From e0de735088b76c3cfd1d8229212432f407079824 Mon Sep 17 00:00:00 2001
From: Sara Mildenstein <115432964+sararocks@users.noreply.github.com>
Date: Wed, 27 Sep 2023 15:04:08 -0600
Subject: [PATCH 1/3] Update login-from-live-disk.md

Added context to encryption section
---
 content/login-from-live-disk.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/content/login-from-live-disk.md b/content/login-from-live-disk.md
index 3172a05eda..3630aeeefe 100644
--- a/content/login-from-live-disk.md
+++ b/content/login-from-live-disk.md
@@ -56,6 +56,8 @@ To access an encrypted disk, run these additional commands to unlock the encrypt
 |:--------------------------------------------------:|:-------------------------------------------------:|
 | ```sudo cryptsetup luksOpen /dev/sda3 cryptdata```       | ```sudo cryptsetup luksOpen /dev/nvme0n1p3 cryptdata``` |
 
+>**Note:** You will see "Enter passphrase for /dev/nvme0n1p3 (or the name of your exact drive):" - Enter your encryption password here. You will "enter this blind," i.e. you won't see the characters typed out. Then press Enter. 
+
 ```bash
 sudo lvscan
 sudo vgchange -ay

From 3f7840cb9aeafb4dcb548365653fc8c1f7c619d5 Mon Sep 17 00:00:00 2001
From: Thomas Zimmerman <thomas@system76.com>
Date: Wed, 27 Sep 2023 16:08:32 -0600
Subject: [PATCH 2/3] Add some additional comments on what the chroot commands
 are doing and fixing lint issues

---
 content/login-from-live-disk.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/content/login-from-live-disk.md b/content/login-from-live-disk.md
index 3630aeeefe..fe991606b5 100644
--- a/content/login-from-live-disk.md
+++ b/content/login-from-live-disk.md
@@ -19,7 +19,7 @@ section: software-troubleshooting
 tableOfContents: true
 ---
 
-## Login from Live Disk (Chroot)
+## Log in from Live Disk (Chroot)
 
 It is possible to mount an OS drive and log into the installed OS with root access. This is called gaining "chroot" (change to root) access. This process is useful when [rescuing files](/articles/disaster-recovery), [fixing package manager issues](/articles/package-manager-pop), or [resetting forgotten user passwords](/articles/password).
 
@@ -56,20 +56,23 @@ To access an encrypted disk, run these additional commands to unlock the encrypt
 |:--------------------------------------------------:|:-------------------------------------------------:|
 | ```sudo cryptsetup luksOpen /dev/sda3 cryptdata```       | ```sudo cryptsetup luksOpen /dev/nvme0n1p3 cryptdata``` |
 
->**Note:** You will see "Enter passphrase for /dev/nvme0n1p3 (or the name of your exact drive):" - Enter your encryption password here. You will "enter this blind," i.e. you won't see the characters typed out. Then press Enter. 
+>**Note:** You will see "Enter passphrase for /dev/nvme0n1p3 (or the name of your exact drive):" - Enter your encryption password here. You will "enter this blind," i.e. you won't see the characters typed out. Then press Enter.
 
 ```bash
+# scan for logical volumes
 sudo lvscan
+# scan and setup volume groups
 sudo vgchange -ay
 ```
 
 >**Note:** Pay attention to what the `cryptdata` group is called. If it is named something other than `data-root`, substitute the correct info into this next command.  Make sure that `-root` is on the end:
 
 ```bash
+# setup access to the encrypted file system on '/mnt'
 sudo mount /dev/mapper/data-root /mnt
 ```
 
-Now the existing hard drive can be accessed by going to the `/mnt` folder.  To use the <u>Files</u> program, go to `+ Other Locations` -> `Computer` and then click on the `/mnt` folder.
+**Note:** If you want to backup your files, you can do so at this point in the process if you don't already have a [backup of your data](/articles/backup-files/)
 
 ## Chroot
 
@@ -82,6 +85,7 @@ The EFI partition is the next partition to be mounted. To help identify it, this
 | ```sudo mount /dev/sda1 /mnt/boot/efi```    | ```sudo mount /dev/nvme0n1p1 /mnt/boot/efi```  |
 
 ```bash
+# mount several "kernel" virtual file systems from the live system to '/mnt/'
 for i in /dev /dev/pts /proc /sys /run; do sudo mount -B $i /mnt$i; done
 sudo chroot /mnt
 ```

From 7742788bbd99615daee8d6cd20b6eea0035f4b2d Mon Sep 17 00:00:00 2001
From: Aaron Honeycutt <aaron@system76.com>
Date: Tue, 3 Oct 2023 14:22:25 -0600
Subject: [PATCH 3/3] Address feedback

---
 content/login-from-live-disk.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/login-from-live-disk.md b/content/login-from-live-disk.md
index fe991606b5..08b137a46f 100644
--- a/content/login-from-live-disk.md
+++ b/content/login-from-live-disk.md
@@ -1,5 +1,5 @@
 ---
-title: Login from Live Disk (Chroot)
+title: Log in from Live Disk (Chroot)
 description: >
     Access an installed OS from a Live Disk/Recovery.
 keywords: