diff --git a/README.adoc b/README.adoc
index 38c5ea9..14d8c3d 100644
--- a/README.adoc
+++ b/README.adoc
@@ -183,20 +183,31 @@ 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 -- `POWER` (Silicon) or `COMMAND + R` (Intel) buttons -- to download and
- install the last operating system used. Alternatively, you can also use `COMMAND + OPTION + R`
- (Intel) 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
- the `OPTION + COMMAND + R + P` (Intel) keys simultaneously. You might want to wait for the system
- boot sound to 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).
+* *Pi-hole*: 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.
+* *Recovery Mode*: When using the boot disk and the installer fails in some catastrophic manner,
+ reboot the machine into recovery mode -- pass:[POWER] (Silicon) or
+ pass:[COMMAND] + pass:[r] (Intel) buttons -- to download and install the
+ last operating system used. Alternatively, you can also use pass:[COMMAND] +
+ pass:[OPTION] + pass:[r] (Intel) to attempt to download the latest operating
+ system.
+* *NVRAM/PRAM Reset*: 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 pass:[OPTION] + pass:[COMMAND] + pass:[r] +
+ pass:[p] (Intel) keys simultaneously. You might want to wait for the system boot sound
+ to 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).
+* *System Management Controller (SMC) Reset*: Sometimes it can help to reset the SMC to improve
+ system speed. To fix, follow these steps:
+** Shut down your Mac.
+** Hold down pass:[CONTROL] + pass:[OPTION] on the left side of the keyboard
+ and pass:[SHIFT] on the right side of the keyboard.
+** After seven seconds, hold down the Power button as well.
+** Release all keys after another seven seconds.
+** Turn on your Mac.
== Development