add more docsHEADmain

1 files changed, 15 insertions, 3 deletions

diff --git a/readme.org b/readme.org
index 6fff04d..6bfa639 100644
--- a/readme.org
+++ b/readme.org
@@ -25,26 +25,37 @@ turn on the ‘esp’ flag for partition ~1~:
 : parted /dev/vdb set 1 esp on
 
 ** create filesystems
+*** esp volume
 : mkfs.vfat -n ESP -F 32 /dev/vdb1
 
+*** btrfs volumes
+note that there is no =/gnu/etc= because =/etc= can, in most cases, be
+created automatically at boot during activation.
+
 : mkfs.btrfs -L root /dev/vdb3
 : mount -m -t btrfs /dev/vdb3 /mnt
-
 : btrfs subvol create /mnt/gnu
 : btrfs subvol create /mnt/gnu/store
-# : btrfs subvol create /mnt/gnu/etc
 : btrfs subvol create /mnt/gnu/var
 : btrfs subvol create /mnt/gnu/boot
 : btrfs subvol create /mnt/persist
 : btrfs subvol create /mnt/persist/home
 : btrfs subvol create /mnt/persist/home/root
 
+*** unmount
+once the filesystems are set up, unmount =/mnt= so we can tmpfs mount it
+later.
 : umount /mnt
 
 ** mount filesystems
+now we mount up enough of the heirarchy so that we can install
+everything. probably not all of these are strictly required, but none
+should cause problems.
+
+we are mounting =/mnt= as tmpfs just to make sure the installer doesn't
+write something to permanent storage that it shouldn't.
 : mount -m -t tmpfs tmpfs /mnt
 : mount -m -t btrfs -o subvol=/gnu LABEL=root /mnt/gnu
-# : mount -m -t btrfs -o subvol=/gnu/etc LABEL=root /mnt/etc
 : mount -m -t btrfs -o subvol=/gnu/var LABEL=root /mnt/var
 : mount -m -t btrfs -o subvol=/gnu/boot LABEL=root /mnt/boot
 : mount -m -t btrfs -o subvol=/persist LABEL=root /mnt/persist
@@ -53,4 +64,5 @@ turn on the ‘esp’ flag for partition ~1~:
 : mount -m -t vfat LABEL=ESP /mnt/boot/esp
 
 ** init system
+once the filesystems are mounted, we can init the system
 : guix system init configuration.scm /mnt