From a3443718187d3715df3bbf490d4ebd882a4fab9c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= <ffloreth@redhat.com>
Date: Thu, 13 Jul 2023 15:13:23 +0200
Subject: [PATCH] docs: refactored _Troubleshooting OpenShift Local_ (#3208)

---
 .../troubleshooting-openshift-local.md        | 28 +++++++++++++++++--
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/website/docs/troubleshooting/troubleshooting-openshift-local.md b/website/docs/troubleshooting/troubleshooting-openshift-local.md
index eeeb0d3dfea..ea02caea92e 100644
--- a/website/docs/troubleshooting/troubleshooting-openshift-local.md
+++ b/website/docs/troubleshooting/troubleshooting-openshift-local.md
@@ -4,6 +4,28 @@ sidebar_position: 100
 
 # Troubleshooting OpenShift Local
 
-- Check which preset is defined. (`crc config get preset`)
-- Check that `crc` binary is available in the user PATH (`/usr/local/bin/crc`)
-- Check that `crc setup --check-only` is running without errors.
+You can find here troubleshooting help for issues specific to OpenShift Local.
+
+1. To verify that your user can run `crc`, verify that the `crc` binary is available in the user PATH (`/usr/local/bin/crc` on macOS and Linux).
+
+2. To verify that the host is ready to run OpenShift Local, in a terminal, run this command and verify the output has no errors:
+
+   ```shell-session
+   $ crc setup --check-only
+   ```
+
+   Sample output:
+
+   ```shell-session
+   INFO Using bundle path <bundle_path>
+   INFO Checking if running as non-root
+   INFO Checking if running inside WSL2
+   INFO Checking if crc-admin-helper executable is cached
+   crc-admin-helper executable is not cached
+   ```
+
+3. To verify the configured preset, in a terminal, run:
+
+   ```shell-session
+   $ crc config get preset
+   ```