docs: update docs for v0.0.5

docs/guide/binary.md

@@ -25,19 +25,19 @@ Pomerium supports setting [configuration variables] using both environmental var
 
 ### Configuration file
 
-Create a config file (`config.yaml`). This configuration file will be use to determine Pomerium's configuration settings, routes, and access-policies. Consider the following example:
+Create a config file (`config.yaml`). This file will be used to determine Pomerium's configuration settings, routes, and access-policies. Consider the following example:
 
 <<< @/docs/docs/examples/config/config.minimal.yaml
 
 ### Environmental Variables
 
-As mentioned above, Pomerium supports mixing and matching where configuration details are set. For example, we can specify our secret values and domains certificates as [environmental configuration variables].
+As mentioned above, Pomerium supports mixing and matching  configuration. For example, we can specify our secret values and domains certificates as [environmental configuration variables], and set the rest as part of the configuration file.
 
 <<< @/docs/docs/examples/config/config.minimal.env
 
 ## Run
 
-Finally, source the the configuration `env` file and run pomerium specifying the `config.yaml` you just created.
+Finally, source the the configuration `env` file and run pomerium specifying the `config.yaml` .
 
 ```bash
 source ./env

docs/guide/from-source.md

@@ -8,12 +8,12 @@ meta:
 
 # Building Pomerium From Source
 
-The following quick-start guide covers how to retrieve and build Pomerium directly from it's source as well as how to run Pomerium using a minimal but complete configuration.
+The following quick-start guide covers how to retrieve and build Pomerium directly from it's source-code as well as how to run Pomerium using a minimal but complete configuration. One of the benefits of compiling from source is that Go supports building static binaries for a [wide array of architectures and operating systems](https://gist.github.com/asukakenji/f15ba7e588ac42795f421b48b8aede63) — some of which may not yet be supported by Pomerium's official images or binaries. 
 
 ## Prerequisites
 
-- Install [git](https://git-scm.com/) version control system
-- Install the [go](https://golang.org/doc/install) programming language
+-  [git](https://git-scm.com/) 
+-  [go](https://golang.org/doc/install) programming language
 - A configured [identity provider]
 - A [wild-card TLS certificate]
 
@@ -34,7 +34,7 @@ cd $HOME/pomerium
 make
 ```
 
-[Make] will run all the tests, some code linters, then build the binary. If all is good, you should now have a freshly built pomerium binary in the `pomerium/bin` directory.
+[Make] will run all the tests, some code linters, then build the binary. If all is good, you should now have a freshly built pomerium binary for your architecture and operating system in the `pomerium/bin` directory.
 
 ## Configure
 
@@ -42,7 +42,7 @@ Pomerium supports setting [configuration variables] using both environmental var
 
 ### Configuration file
 
-Create a config file (`config.yaml`). This configuration file will be use to determine Pomerium's configuration settings, routes, and access-policies. Consider the following example:
+Create a config file (`config.yaml`). This file will be use to determine Pomerium's configuration settings, routes, and access-policies. Consider the following example:
 
 <<< @/docs/docs/examples/config/config.minimal.yaml
 
@@ -54,7 +54,7 @@ As mentioned above, Pomerium supports mixing and matching where configuration de
 
 ## Run
 
-Finally, source the the configuration `env` file and run pomerium specifying the `config.yaml` you just created.
+Finally, source the the configuration `env` file and run pomerium specifying the configuration file `config.yaml`.
 
 ```bash
 source ./env

docs/guide/helm.md

@@ -10,7 +10,7 @@ meta:
 
 This quickstart will show you how to deploy Pomerium with Kubernetes. Though there are [many ways](https://kubernetes.io/docs/setup/pick-right-solution/) to work with Kubernetes, for the purpose of this guide, we will be using Google's [Kubernetes Engine](https://cloud.google.com/kubernetes-engine/). That said, most of the following steps should be very similar using any other provider.
 
-In addition to sharing many of the same features as the Kubernetes quickstart guide, the default helm deployment script also includes a bootstrapped certificate authority enabling mutually authenticated and encrypted communication between services that does not depend on the external LetsEncrypt certificates. Having the external domain certificate decoupled makes it easier to renew external certificates. 
+In addition to sharing many of the same features as the Kubernetes quickstart guide, the default helm deployment script also includes a bootstrapped certificate authority enabling mutually authenticated and encrypted communication between services that does not depend on the external LetsEncrypt certificates. Having the external domain certificate de-coupled makes it easier to renew external certificates. 
 
 ## Prerequisites
 

docs/guide/readme.md

@@ -3,12 +3,12 @@ title: Docker
 lang: en-US
 meta:
   - name: keywords
-    content: pomerium identity-access-proxy oidc docker reverse-proxy
+    content: pomerium identity-access-proxy oidc docker reverse-proxy containers
 ---
 
 # Pomerium using Docker
 
-[Docker] is a simple and easy way to start using Pomerium. In the following quick-start, we'll create a minimal but complete environment for running Pomerium with containers.
+[Docker] is a straightforward way to start using Pomerium. In the following quick-start, we'll create a minimal but complete environment for running Pomerium with containers.
 
 ## Prerequisites
 
@@ -22,7 +22,7 @@ meta:
 
 Download the following `docker-compose.yml` file and modify it to:
 
-- use newly generated secrets
+- generate new secrets
 - mount your [wild-card TLS certificate]
 - mount Pomerium's `config.yaml` [configuration file]