diff --git a/README.md b/README.md
index 514f464..1e3d02f 100644
--- a/README.md
+++ b/README.md
@@ -82,12 +82,12 @@ Legend:
 
 ### Errors in Output
 
-If there is an error checking an image the tool will display the 🚫 symbol and give a short description of the error at the end of the line. The current common errors are:
+If there is an error whilst checking an image, the tool will display the 🚫 symbol and give a short description of the error at the end of the line. The current common errors are:
 
 - Authentication error. This usually means that you are missing your docker credentials or that you are denied access to the registry.
 - Communication error. Could mean that the URL host doesn't exist or that its down.
 - Image not found.
-- Unknown error, run in debug mode for more info -d
+- Unknown error, run in debug mode using the flag `-d` for more info
 
 ## Private Registry Authentication
 
diff --git a/changes/19.feature b/changes/19.feature
index 4cd1387..e2e772e 100644
--- a/changes/19.feature
+++ b/changes/19.feature
@@ -1 +1 @@
-added better erorr messages for common cases, and added a new -l flag for logging into a log file.
+Added better error messages for common cases, and added a new `-l` flag for logging into a log file.
diff --git a/internal/images/images.go b/internal/images/images.go
index 96139bd..55347ef 100644
--- a/internal/images/images.go
+++ b/internal/images/images.go
@@ -59,7 +59,7 @@ func GetFriendlyErrorMessage(err error) string {
 	case containsAnyOf(errorMessage, []string{"no such host"}):
 		return "|| communication error, check your url host."
 	default:
-		return "|| An unknown error occurred. Please run with debug -d for more details."
+		return "|| An unknown error occurred. Please run in debug mode using the flag '-d' for more details."
 	}
 }