feat(docs): Minor updates to Docs

Author: sylus

content/en/docs/development/theming/_index.en.md

@@ -45,7 +45,27 @@ c) Point to your new sub theme for **[WxT Library][wxt_library]** to properly lo
 
 If the theme you are extending has custom block templates these won't be immediately inherited because a sub-theme creates copies of all the blocks in the parent theme and renames them with the sub-theme's name as a prefix. Twig block templates are derived from the block's name, so this breaks the link between these templates and their block.
 
-To fix this problem it requires a hook in the sub-theme by adding the following code snippet to the `THEMENAME.theme` file:
+Fixing this problem currently requires a hook in the `THEMENAME.theme` file and should have the following contents:
+
+```sh
+/**
+ * Implements hook_theme_suggestions_HOOK_alter().
+ */
+function THEMENAME_theme_suggestions_block_alter(&$suggestions, $variables) {
+  // Load theme suggestions for blocks from parent theme.
+  // https://www.drupal.org/project/wxt/issues/3310485#comment-14715969
+  for ($i = 0; $i < count($suggestions); $i++) {
+    if (str_contains($suggestions[$i], 'THEMENAME_')) {
+      $new_suggestions = [
+        str_replace('THEMENAME_', '', $suggestions[$i]),
+        str_replace('THEMENAME_', 'wxt_bootstrap_', $suggestions[$i]),
+      ];
+      array_splice($suggestions, $i, 0, $new_suggestions);
+      $i += 2;
+    }
+  }
+}
+```
 
 ### Programmatic Logic
 

content/en/docs/environment/containers/_index.en.md

@@ -59,13 +59,25 @@ make drupal_install
 ./docker/bin/drush migrate:import --group gcweb --tag 'Menu'
 ```
 
-## MacOSX Environments
+## Modern OSX Environments
 
-There are currently known performance issues related to the file mounting in `Docker for Desktop`
+If you have `Docker for Desktop` and a new enough OSX environment (Monterey or higher) then the steps are the exact same as those for the Linux environment given above.
 
-- **[Improve Mac File system performance][docker-mac]**
+All that is required in advance is to enable `VirtioFS` accelerated directory sharing which you can see in the attached picture below.
+
+{{< imgproc virtiofs Resize "x300" >}}
+Docker for Desktop VirtioFS
+{{< /imgproc >}}
+
+For older environments you may still use mutagen which is discussed below.
+
+## Legacy OSX Environments (Mutagen)
 
-This is supposed to be fixed with the new virtualization framework in MacOSX 11.1+ but for the moment mutagen should be used.
+While this is fixed with the new virtualization framework discussed above.
+
+For older environments mutagen will have to be used instead and as such requires a few additional steps.
+
+- **[Improve Mac File system performance][docker-mac]**
 
 ```sh
 # Mutagen Setup
@@ -104,14 +116,20 @@ make drupal_install
 ./docker/bin/drush migrate:import --group gcweb --tag 'Menu'
 ```
 
-Afterwards if you wish to have an empty docker environment you may execute the following commands.
+## Cleanup
+
+If you wish to have a pristine docker environment you may execute the following commands.
 
 ```sh
-mutagen sync terminate <sync_xxxxx>
 docker rm $(docker ps -a -q)
 docker rmi $(docker images -q) --force
 docker volume prune -f
+```
 
+For those still using Mutagen you may also need to execute the following command:
+
+```sh
+mutagen sync terminate <sync_xxxxx>
 ```
 
 <!-- Links Referenced -->