diff --git a/docs/faq.md b/docs/faq.md
index 282dc49d76c06df37f534be262269813357464e5..8b0e27d51b260c9a2e7cf77763fefd352d0c7924 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -1,55 +1,32 @@
 # Frequently Asked Questions
 
-**Q: I get an error "sqlite3_node" not found or something like that.**
-
-**A:** You need to rebuild your native sqlite3 bindings.
-
-To fix this in most cases, run:
-
-- `npm install`
-- `./node_modules/.bin/electron-rebuild -w sqlite3 -p`
-
-If it still doesn't get fixed, do:
+**Q: How to make this work on Mac/Linux?**
 
-- `rm -rf node_modules`
-  and then try again the above commands.
-
-Occasionally upgrading your `npm` also makes a difference:
+**A:**
 
-- `npm install -g npm`
+`npm install` is used to download all required dependency packages.
 
----
+If you see errors related to `node-gyp` and missing local libraries, like `pixman`, etc, it means there are missing native dependencies to satisfy to compile non-prebuilt node binaries for some combination of platforms and versions. Npm on the cloud is constantly updating the list of provided binaries, so it's possible that you will pick them up just fine, but if you don't, these are instructions for different platforms:
 
-**Q: I get an error during `node install`, something related to `node-gyp` and missing local libraries, like `pixman`, etc.**
+- **OSX on a Mac** with Homebrew `brew`:
 
-**A:** There are some native dependencies that you have to satisfy to compile non-prebuilt node binaries for some combination of platforms and versions. Npm on the cloud is constantly updating the list of provided binaries, so it's possible that you will pick them up just fine, but if you don't, these are instructions for different platforms:
+```
+brew install pkg-config cairo pango libpng jpeg giflib librsvg
+```
 
-- Fedora Core with `dnf`:
+- **Fedora Core** with `dnf`:
 
 ```
 dnf install pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
 ```
 
-- Ubuntu with `apt-get`:
+- **Ubuntu** with `apt-get`:
 
 ```
 apt-get update
 apt-get install --fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
 ```
 
-- OSX on a Mac:
-
-```
-Using Homebrew install the following:
-- pixman
-- cairo
-- pango
-- libjpeg
-for example: brew install pixman
-```
-
-- Windows: see next FAQ entry: "How to make this work on Windows?".
-
 ---
 
 **Q: How to make this work on Windows?**
@@ -60,7 +37,9 @@ Make sure its always up to date and there are no changes that haven't been commi
 
 You must use Chocolately to make Zap work on Windows. Make sure to download the pkgconfiglite package
 
-- choco install pkgconfiglite
+```
+choco install pkgconfiglite
+```
 
 If you have issues with cairo, for exaple if you get an error about cairo.h': No such file or directory
 
@@ -101,6 +80,26 @@ References:
 
 ---
 
+**Q: I get an error "sqlite3_node" not found or something like that.**
+
+**A:** You need to rebuild your native sqlite3 bindings.
+
+To fix this in most cases, run:
+
+- `npm install`
+- `./node_modules/.bin/electron-rebuild -w sqlite3 -p`
+
+If it still doesn't get fixed, do:
+
+- `rm -rf node_modules`
+  and then try again the above commands.
+
+Occasionally upgrading your `npm` also makes a difference:
+
+- `npm install -g npm`
+
+---
+
 **Q: My development PC doesn't work with zap for whatever reason. Can I use a docker container?**
 
 **A:** Yes you can. TBD.