Updated 3.6.x notes FAQ (markdown)

3.6.x-notes-FAQ.md

@@ -1,10 +1,20 @@
-## What was deprecated in 3.6?
-- `wc_get_min_max_price_meta_query` – removed in favour of lookup tables which remove the need to filter via post meta.
-- Term meta helper functions – deprecated in favour of WP core term meta functions such as https://developer.wordpress.org/reference/functions/get_term_meta/. These have not been needed since WP 4.4.
-- `WC_Country::load_country_states` – States are now loaded on the fly as needed.
-- `WC_Cache_Helper::delete_version_transients` – Transients are now versioned within the value negating the need for cleanup.
-- `WC_Background_Updater` – We’ve switched updates to the ActionScheduler queue.
-- `Simplify Commerce` – This gateway has been deprecated for several years and hidden in the UI. The code has now been removed.
+## The database update has been running for hours/is not completing
+
+As of 3.6.x database updates are ran using Action Scheduler which uses a system based upon WP Cron. **If WP Cron is disabled on your system, or cron jobs are delayed, these jobs may never run, or may take longer than usual to run.**
+
+You can check if cron is disabled in the status report; WooCommerce > Status.
+
+Updates can be ran manually via Tools > Scheduled Actions > Pending (click run next to each task). This screen can also help you check progress of the queued updates.
+
+## I am having issues sorting/searching by SKU after the update
+
+In 3.6, we've extracted data such as product SKU to a lookup table to improve performance during sorting, filtering, and searching, so if the lookup table is not populated correctly you might experience problems searching for SKUs amongst other things.
+
+The database update for 3.6 must be complete for these queries to work correctly.
+
+- Ensure you clicked the 'update database' notice after updating to 3.6. Wait for the job to complete (or see above if it's taking a while).
+- Check WooCommerce > Status > Scheduled Actions. If you have any upgrade tasks pending there, you can run them manually by clicking on the Run link that appears on mouse over in the list of Pending actions.
+- You can Regenerate Product lookup tables via WooCommerce > Status > Tools.
 
 ## Will there be any database issues if I downgrade to 3.5.x after updating to 3.6.x?
 
@@ -38,4 +48,12 @@ into:
 $emogrifier = new \Pelago\Emogrifier( $content, $css );
 ```
 
-Emogrifier is used by WooCommerce behind the scenes and only loaded where needed. We have no anticipated this being used by 3rd parties directly, so if you are a developer using this please get in touch with your use-case so we can consider (for example) a wrapper around this to prevent the need for direct calls/including core classes manually (which is likely to conflict in the future).
+Emogrifier is used by WooCommerce behind the scenes and only loaded where needed. We did not anticipate this being used by 3rd parties directly, so if you are a developer using this please get in touch with your use-case so we can consider (for example) a wrapper around this to prevent the need for direct calls/including core classes manually (which is likely to conflict in the future).
+
+## What was deprecated in 3.6?
+- `wc_get_min_max_price_meta_query` – removed in favour of lookup tables which remove the need to filter via post meta.
+- Term meta helper functions – deprecated in favour of WP core term meta functions such as https://developer.wordpress.org/reference/functions/get_term_meta/. These have not been needed since WP 4.4.
+- `WC_Country::load_country_states` – States are now loaded on the fly as needed.
+- `WC_Cache_Helper::delete_version_transients` – Transients are now versioned within the value negating the need for cleanup.
+- `WC_Background_Updater` – We’ve switched updates to the ActionScheduler queue.
+- `Simplify Commerce` – This gateway has been deprecated for several years and hidden in the UI. The code has now been removed.