From cc75094d5f733536fc30d198a48245a4f52f674e Mon Sep 17 00:00:00 2001 From: Brooke Kuhlmann Date: Thu, 20 Dec 2018 09:30:49 -0700 Subject: [PATCH] Added README troubleshooting section. Discovered this situation while wanting to rebuild a recently rebuilt machine of the same operation system version. At first, thought the original bootdisk was corrupted but turns out the system NVRAM/PRAM was causing the issue. --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 6ddab73..3ec3131 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,7 @@ the two projects are meant to be used: - [Setup](#setup) - [Usage](#usage) - [Customization](#customization) + - [Troubleshooting](#troubleshooting) - [Versioning](#versioning) - [Code of Conduct](#code-of-conduct) - [Contributions](#contributions) @@ -152,6 +153,16 @@ project is built upon the functions found in the `lib` folder. See the - `lib/settings.sh`: Defines global settings for software applications, extensions, etc. +## Troubleshooting + +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 the system and boot it up again while holding down the +`OPTION+COMMAND+R+P` 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 as recommended (the boot disk +will be recognized now). + ## Versioning Read [Semantic Versioning](https://semver.org) for details. Briefly, it means: