firezone · jamilbk · Feb 11, 2022 · Feb 9, 2022 · Feb 10, 2022 · Feb 10, 2022
diff --git a/docs/docs/administer/troubleshoot.md b/docs/docs/administer/troubleshoot.md
@@ -49,3 +49,12 @@ table inet firezone {
   }
 }
 ```
+
+## Need additional help?
+
+If you're looking for help installing, configuring, or using Firezone, we're
+happy to help.
+
+* [Discussion Forums](https://discourse.firez.one/): ask questions, report bugs, and suggest features
+* [Public Slack Group](https://join.slack.com/t/firezone-users/shared_invite/zt-111043zus-j1lP_jP5ohv52FhAayzT6w): join discussions, meet other users, and meet the contributors
+* [Email Us](mailto:team@firez.one): we're always happy to chat
diff --git a/docs/docs/deploy/clients.md b/docs/docs/deploy/clients.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Install Clients
-nav_order: 5
+nav_order: 4
 parent: Deploy
 ---
 ---
@@ -15,4 +15,7 @@ Once the WireGuard client is installed, users can add the tunnel by
 importing the `.conf` file sent by the administrator or logging into the
 Firezone web UI and downloading a `.conf` file there.
 
-![Client Instructions]({{ site.asset_urls.client_instructions }})
+![Client Instructions]({{ site.asset_urls.client_instructions }}){: width="600" }
+
+\
+[Previous: Install Server]({% link docs/deploy/server.md %}){: .btn .mr-2}
diff --git a/docs/docs/deploy/index.md b/docs/docs/deploy/index.md
@@ -3,4 +3,10 @@ layout: default
 title: Deploy
 nav_order: 2
 has_children: true
+has_toc: false
 ---
+
+Firezone can be deployed on most popular Linux distributions in a few minutes. Please start by checking the [supported platforms]({% link docs/deploy/supported-platforms.md %}) for your particular distribution. A kernel upgrade may be required to ensure WireGuard is supported.
+
+\
+[Start Here: Supported Platforms]({% link docs/deploy/supported-platforms.md %}){: .btn .btn-purple }
diff --git a/docs/docs/deploy/prerequisites.md b/docs/docs/deploy/prerequisites.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Prerequisites
-nav_order: 3
+nav_order: 2
 parent: Deploy
 ---
 ---
@@ -29,3 +29,7 @@ but for now these must be generated manually and specified in the main
 configuration file at `/etc/firezone/firezone.rb`. See here for a guide on how
 to do so:
 [https://eff-certbot.readthedocs.io/en/stable/using.html#manual](https://eff-certbot.readthedocs.io/en/stable/using.html#manual)
+
+\
+[Previous: Supported Platforms]({% link docs/deploy/supported-platforms.md %}){: .btn .mr-2}
+[Next: Install Server]({% link docs/deploy/server.md %}){: .btn .btn-purple }
diff --git a/docs/docs/deploy/resource-requirements.md b/docs/docs/deploy/resource-requirements.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Resource Requirements
-nav_order: 2
+nav_order: 5
 parent: Deploy
 ---
 ---

diff --git a/docs/docs/deploy/server.md b/docs/docs/deploy/server.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Install Server
-nav_order: 4
+nav_order: 3
 parent: Deploy
 ---
 ---
@@ -50,5 +50,8 @@ configure Firezone for first use:
 8. Now you should be able to log into the web UI at the FQDN you specified in
    step 5 above, e.g. `https://firezone.example.com`
 
-Next, proceed to [install WireGuard clients
-]({% link docs/deploy/clients.md %}).
+Find solutions to common issues during deployment in [Troubleshoot]({% link docs/administer/troubleshoot.md %}).
+
+\
+[Previous: Prerequisites]({% link docs/deploy/prerequisites.md %}){: .btn .mr-2}
+[Next: Install WireGuard Clients]({% link docs/deploy/clients.md %}){: .btn .btn-purple }
diff --git a/docs/docs/deploy/supported-platforms.md b/docs/docs/deploy/supported-platforms.md
@@ -115,3 +115,6 @@ not have it installed by default. To fix, ensure `libcap-progs` is installed:
 ```shell
 sudo zypper install libcap-progs
 ```
+
+\
+[Next: Prerequisites]({% link docs/deploy/prerequisites.md %}){: .btn .btn-purple }
diff --git a/docs/docs/user-guides/add-devices.md b/docs/docs/user-guides/add-devices.md
@@ -9,7 +9,7 @@ parent: User Guides
 Add a device through the Web UI by clicking the "Add Device" button under
 `/devices` or `/users`.
 
-![add device](https://user-images.githubusercontent.com/52545545/152582102-7bde379a-57d5-4f35-9b4e-4d02c32241bc.png)
+![add device](https://user-images.githubusercontent.com/52545545/152582102-7bde379a-57d5-4f35-9b4e-4d02c32241bc.png){: width="600" }
 
 Once the device profile is created, you can send the WireGuard configuration
 file to the user by:

diff --git a/docs/docs/user-guides/add-users.md b/docs/docs/user-guides/add-users.md
@@ -15,6 +15,6 @@ Add a user by clicking the "Add User" button under `/users`. You will be asked
 to specify an email and a password for the user. These credentials will be used
 to authenticate the user so they are able to establish the connection.
 
-![add user](https://user-images.githubusercontent.com/52545545/152580539-bdf10332-a528-4650-a0fe-e72bca89e98a.png)
+![add user](https://user-images.githubusercontent.com/52545545/152580539-bdf10332-a528-4650-a0fe-e72bca89e98a.png){: width="600" }
 
 Next, [add devices]({% link docs/user-guides/add-devices.md %}) to the user.
diff --git a/docs/docs/user-guides/firewall-rules.md b/docs/docs/user-guides/firewall-rules.md
@@ -11,4 +11,4 @@ via the kernel's netfilter system. By default, all traffic is allowed.
 
 The Allowlist and Denylist support both IPv4 and IPv6 CIDRs and IP addresses.
 
-![firewall rules](https://user-images.githubusercontent.com/52545545/152583668-99077cb3-f83b-4ca4-8641-2e8b2ae5d061.png)
+![firewall rules](https://user-images.githubusercontent.com/52545545/152583668-99077cb3-f83b-4ca4-8641-2e8b2ae5d061.png){: width="600" }
diff --git a/docs/index.md b/docs/index.md
@@ -9,21 +9,29 @@ description: >
 
 ---
 
+![Architecture](https://user-images.githubusercontent.com/52545545/147286088-08b0d11f-d81d-4622-8145-179071d2f0fb.png){: width="600" }
+
 [Firezone](https://firez.one) is an open source, self-hosted VPN server and
 egress firewall for Linux. Use it to **quickly and easily** secure access to
 your private network and internal applications from a simple Web UI.
 
+These docs explain how to deploy, configure, and use Firezone.
+
 ## Quick Start
 
-1. [Deploy]({% link docs/deploy/index.md %})
-1. [Administer]({% link docs/administer/index.md %})
-1. [User Guides]({% link docs/user-guides/index.md %})
+1. [Deploy]({% link docs/deploy/index.md %}): A step-by-step walkthrough of setting up Firezone. Start here if you are new.
+1. [Administer]({% link docs/administer/index.md %}): This section relates directly to configuring the server instance.
+1. [User Guides]({% link docs/user-guides/index.md %}): Useful guides to help you learn how to use Firezone and trouble shoot common issues. Consult this section after you successfully deploy the Firezone server.
 
 ## Get Help
 
 If you're looking for help installing, configuring, or using Firezone, we're
 happy to help.
 
-* [Discussion Forums](https://discourse.firez.one/)
-* [Public Slack Group](https://join.slack.com/t/firezone-users/shared_invite/zt-111043zus-j1lP_jP5ohv52FhAayzT6w)
-* [Email Us](mailto:team@firez.one)
+* [Discussion Forums](https://discourse.firez.one/): ask questions, report bugs, and suggest features
+* [Public Slack Group](https://join.slack.com/t/firezone-users/shared_invite/zt-111043zus-j1lP_jP5ohv52FhAayzT6w): join discussions, meet other users, and meet the contributors
+* [Email Us](mailto:team@firez.one): we're always happy to chat
+
+## Contribute to Firezone
+
+We deeply appreciate any and all contributions to the project and do our best to ensure your contribution is included. To get started, see [CONTRIBUTING.md](https://github.com/firezone/firezone/blob/master/CONTRIBUTING.md).