Logging/debugging info

Author: AugustMiller

docs/troubleshooting.md

@@ -21,14 +21,18 @@ For example, if you're mapping 20+ fields for an Entry import, but it isn't work
 
 ### Logging
 
-Feed Me create a log event for just about everything it does, notably errors, but other useful information. If you're experiencing issues or unexpected results with a Feed, consult the Logs tab first.
+Feed Me create a log event for just about everything it does, including errors and other status information. If you're experiencing issues or unexpected results with a Feed, consult the **Logs** tab first.
 
 ![The Logs tab](./screenshots/feedme-logs.png)
 
 ### Debugging
 
-There is a special controller action to assist with debugging your feed, should you encounter issues, or errors during an import. The easiest way to get to this is clicking on the small 'bug' icon on the feeds index page (image below). The icon is placed in the Actions column on the far right, but only visible when [devMode](https://craftcms.com/docs/config-settings#devMode) is turned on.
+Feed Me includes a special view to assist with debugging your feed, should you encounter issues or errors during an import. With [devMode](https://craftcms.com/docs/config-settings#devMode) enabled, click the “gear” in the problematic feed’s row to expand its utility drawer, then click **Debug**.
 
 ![Feedme Overview](./screenshots/feedme-overview.png)
 
-The output from this page will be in raw format, providing you with as much information as possible about your feed settings, field-mappings and data. If there are code exceptions, they'll appear on this page.
+Debug output will be a combination of [`print_r`](https://www.php.net/manual/en/function.print-r.php)-formatted objects and log messages, providing you with as much information as possible about your feed settings, field-mappings, and data. If exceptions occur while processing the feed, they’ll appear on this page, too.
+
+::: warning
+Debugging a feed attempts to actually run the import, so make sure you have [backups](./feature-tour/creating-your-feed.md#backup) on, or are working in a disposable environment!
+:::