docs: general design fixes (#2545)

* general fixes to the docs design

* fix condition checking for auto color scheme

docs/content/troubleshooting/documentation-error.md

@@ -1,7 +1,23 @@
-# Documentation Error
+# Troubleshooting Documentation Errors
+
+## React Hook Errors
 
 If you have installed the dependencies in the root of the Medusa repository (that is, if you have a `node_modules` directory at the root of the Medusa repository), this will cause an error when running the documentation website. 
 
 This is because the content resides in `docs/content`. When that content is being imported from there, a mix up can happen between the dependencies in the root of the Medusa repository and the dependencies in `www/docs` which causes an `invalid hook call` error.
 
 For that reason, when the `start` and `build` scripts in `www/docs` are used, the `clean-node-modules` script is called. This script deleted the `node_modules` directory in the root of the Medusa repository.
+
+## Out of Memory Error
+
+If you receive the following error when you run the `build` command in `www/docs`:
+
+```bash
+FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory
+```
+
+Then, run the `build` command with the `NODE_OPTIONS` environment variable set:
+
+```bash npm2yarn
+NODE_OPTIONS="--max-old-space-size=8192" npm run build
+```