1 files changed, 6 insertions, 2 deletions
diff --git a/doc/administration/troubleshooting/debug.md b/doc/administration/troubleshooting/debug.md
index 55fd6462bc3..5daf34c1011 100644
--- a/doc/administration/troubleshooting/debug.md
+++ b/doc/administration/troubleshooting/debug.md
@@ -7,6 +7,10 @@ in production.
 
 Troubleshooting and debugging your GitLab instance often requires a
 [Rails console](https://guides.rubyonrails.org/command_line.html#rails-console).
+See also:
+
+- [GitLab Rails Console Cheat Sheet](gitlab_rails_cheat_sheet.md).
+- [Navigating GitLab via Rails console](navigating_gitlab_via_rails_console.md).
 
 **For Omnibus installations**
 
@@ -73,7 +77,7 @@ sudo gitlab-rails runner "RAILS_COMMAND"
 # Example with a two-line Ruby script
 sudo gitlab-rails runner "user = User.first; puts user.username"
 
-# Example with a ruby script file
+# Example with a ruby script file (make sure to use the full path)
 sudo gitlab-rails runner /path/to/script.rb
 ```
 
@@ -85,7 +89,7 @@ sudo -u git -H bundle exec rails runner -e production "RAILS_COMMAND"
 # Example with a two-line Ruby script
 sudo -u git -H bundle exec rails runner -e production "user = User.first; puts user.username"
 
-# Example with a ruby script file
+# Example with a ruby script file (make sure to use the full path)
 sudo -u git -H bundle exec rails runner -e production /path/to/script.rb
 ```