Added version release notes

Improves labeling and categorization consistency while also cleaning up
some of the README terminology.

The recovery option is more of a last resort, provided by Apple, should
something catastrophic happen with the boot disk.

CHANGES.adoc

@@ -1,5 +1,17 @@
 = Changes
 
+== 11.1.1 (2021-01-10)
+
+* Fixed brew formulae list error - Brooke Kuhlmann
+* Updated boot disk recovery documentation - Brooke Kuhlmann
+
+== 11.1.0 (2021-01-03)
+
+* Added caffeination to restore process - Brooke Kuhlmann
+* Updated boot disk instructions for main disk format - Brooke Kuhlmann
+* Updated troubleshooting documentation - Brooke Kuhlmann
+* Removed README Startup Security Utility documentation - Brooke Kuhlmann
+
 == 11.0.0 (2020-12-30)
 
 * Fixed Circle CI configuration for Bundler config path - Brooke Kuhlmann

README.adoc

@@ -16,10 +16,10 @@ Config_ project is an opinionated configuration which meets the needs of my deve
 but is also meant to serve as an example and guide for building your own personalized setup. Here is
 how the two projects are meant to be used:
 
-* *macOS* (this project) - The foundation framework for building customizated macOS machine setups.
+* *macOS* (this project) - The foundational framework for building custom macOS machine setups.
 * *link:https://www.alchemists.io/projects/mac_os-config[macOS Configuration]* - The layer on top of
-  this _macOS_ project which defines a custom machine setup and base implementation. The project is
+  this _macOS_ project which defines a custom machine implementation. The project is meant to be
-  meant to be forked for as many custom machine setups as needed.
+  forked for as many custom machine setups as needed.
 
 toc::[]
 
@@ -57,7 +57,7 @@ To install, run:
 ----
 git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
-git checkout 11.0.0
+git checkout 11.1.1
 ----
 
 == Usage
@@ -128,43 +128,17 @@ macOS Boot Disk Usage:
   2. Reboot the machine.
   3. Hold down the OPTION key before the Apple logo appears.
   4. Select the USB boot disk from the menu.
-  5. Use Disk Utility to format the machine's drive as "APFS (Encrypted)".
+  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions.
-  6. Install the new operating system.
+  6. Use Disk Utility to create a single "APFS" drive as a "GUID Partition Table".
+  7. Install the new operating system.
 
-macOS Reinstall:
+macOS Boot Disk Recovery:
-  1. Click the Apple icon from the operating system main menu.
+  1. Start/restart the machine.
-  2. Select the "Restart..." menu option.
+  2. Hold down the COMMAND+R keys before the Apple logo appears.
-  3. Hold down the COMMAND+R keys before the Apple logo appears.
+  3. Wait for the macOS installer to load from the recovery partition.
-  4. Wait for the macOS installer to load from the recovery partition.
+  4. Use the dialog options to launch Disk Utility, reinstall the system, etc.
-  5. Use the dialog options to launch Disk Utility, reinstall the system, etc.
 ....
 
-Depending on your security settings, you might need to use the Startup
-Security Utility before using the Boot Disk (see below).
-
-=== https://support.apple.com/en-us/HT208198[Startup Security Utility]
-
-With newer hardware, you should be running with the Apple T2 Security Chip (found via  → About This
-Mac → Overview → System Report → Controller). In order to boot your machine using the Boot Disk,
-you’ll need to _temporarily_ disable the default security settings as follows:
-
-* Turn on or restart your Mac, then press and hold `COMMAND + R` immediately after seeing the Apple
-  logo.
-* Select Utilities → Startup Security Utility from the main menu.
-* Click _Turn Off Firmware Password_.
-* Select _Secure Boot: No Security_.
-* Select _External Boot: Allow booting from external media_.
-* Quit the utility and restart the machine.
-
-You’ll now be able to boot your system with the Boot Disk (see above).
-
-After the new operating system has been installed via the Boot Disk, _ensure you return to the
-Startup Security Utility and re-enable the following settings_:
-
-* Click _Turn On Firmware Password_.
-* Select _Secure Boot: Full Security_.
-* Select _External Boot: Disallow booting from external or removable media_.
-
 === Customization
 
 All executable scripts can be found in the `bin` folder:
@@ -194,6 +168,13 @@ link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for
 
 == Troubleshooting
 
+* When using link:https://pi-hole.net[Pi-hole], you might need to temporarily disable prior to
+  upgrading as you might experience various errors with Apple not being able to detect an internet
+  connection which prevents the installer from working.
+* When using the boot disk and the installer fails in some catestrophic manner, reboot the machine
+  into recovery mode (i.e. `COMMAND + R`) to download and install the last operating system used.
+  Alternatively, you can also use `COMMAND + OPTION + R` to attemp to download the latest operating
+  system.
 * When using the boot disk, you might experience a situation where you see a black screen with a
   white circle and diagonal line running through it. This means macOS lost or can’t find the boot
   disk for some reason. To correct this, shut down and boot up the system again while holding down
@@ -201,13 +182,6 @@ link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for
   happen a few times before releasing the keys. This will clear the system NVRAM/PRAM. At this point
   you can shut down and restart the system following the boot disk instructions (the boot disk will
   be recognized now).
-* Sometimes, when installing XCode development tools (i.e. the `t` option), not all of the macOS
-  headers will be installed. This can cause issues with compiling and building native packages. For
-  example: `fatal error: 'stdio.h' file not found`. This can happen due to an intermittent bug with
-  the XCode installer. To fix this, you’ll need to install this package:
-  `/Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg`. Depending on
-  your system, the version might differ, so look for a `*.pkg` in the
-  `/Library/Developer/CommandLineTools/Packages` folder.
 
 == Development
 

bin/create_boot_disk

@@ -11,14 +11,14 @@ printf "  1. Insert the USB boot disk into the machine to be upgraded.\n"
 printf "  2. Reboot the machine.\n"
 printf "  3. Hold down the OPTION key before the Apple logo appears.\n"
 printf "  4. Select the USB boot disk from the menu.\n"
-printf "  5. Use Disk Utility to format the machine's drive as \"APFS (Encrypted)\".\n"
+printf "  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions.\n"
-printf "  6. Install the new operating system.\n"
+printf "  6. Use Disk Utility to create a single \"APFS\" drive as a \"GUID Partition Table\".\n"
-printf "\nmacOS Reinstall:\n"
+printf "  7. Install the new operating system.\n"
-printf "  1. Click the Apple icon from the operating system main menu.\n"
+printf "\nmacOS Boot Disk Recovery:\n"
-printf "  2. Select the \"Restart...\" menu option.\n"
+printf "  1. Start/restart the machine.\n"
-printf "  3. Hold down the COMMAND+R keys before the Apple logo appears.\n"
+printf "  2. Hold down the COMMAND+R keys before the Apple logo appears.\n"
-printf "  4. Wait for the macOS installer to load from the recovery partition.\n"
+printf "  3. Wait for the macOS installer to load from the recovery partition.\n"
-printf "  5. Use the dialog options to launch Disk Utility, reinstall the system, etc.\n"
+printf "  4. Use the dialog options to launch Disk Utility, reinstall the system, etc.\n"
 
 printf "\nCreating macOS boot disk...\n"
 

lib/options.sh

@@ -39,6 +39,7 @@ process_option() {
       bin/setup_software
       clean_work_path;;
     'R')
+      caffeinate_machine
       bin/restore_backup;;
     'c')
       verify_homebrew_formulas

lib/verifiers.sh

@@ -6,7 +6,7 @@
 verify_homebrew_formulas() {
   printf "Checking Homebrew formulas...\n"
 
-  local applications="$(brew list)"
+  local applications="$(brew list --formulae)"
 
   while read line; do
     if [[ "$line" == "brew install"* ]]; then
@@ -29,7 +29,7 @@ export -f verify_homebrew_formulas
 verify_homebrew_casks() {
   printf "\nChecking Homebrew casks...\n"
 
-  local applications="$(brew list --cask)"
+  local applications="$(brew list --casks)"
 
   while read line; do
     if [[ "$line" == "brew cask install"* ]]; then