replace all remaining doc: refs (#21)

Author: osterman

content/aws/aws-well-architected-framework.md

@@ -1,5 +1,4 @@
 ---
 title: AWS Well-Architected Framework
 excerpt: ''
-draft: true
 ---

content/aws/organizations/best-practices.md

@@ -1,7 +1,6 @@
 ---
 title: AWS Organizations Best Practices
 excerpt: ''
-draft: true
 tags:
   - organizations
   - aws

content/development/12-factor-pattern.md

@@ -1,5 +1,4 @@
 ---
 title: 12 Factor Pattern
 excerpt: ''
-draft: true
 ---

content/geodesic/geodesic-design.md

@@ -8,7 +8,7 @@ weight: -1
 
 We designed this shell as the last layer of abstraction. It stitches all the tools together like `make`, `aws-cli`, `kops`, `helm`, `kubectl`, and `terraform`. As time progresses, there will undoubtedly be even more that come into play. For this reason, we chose to use a combination of `bash` and `make` which together are ideally suited to combine the strengths of all these wonderful tools into one powerful shell, without raising the barrier to entry too high.
 
-For the default environment variables, check out `Dockerfile`. We believe using ENVs this way is both consistent with the "cloud" ([12 Factor Pattern](doc:12-factor-pattern)) way of doing things, as well as a clear way of communicating what values are being passed without using a complicated convention. Additionally, you can set & forget these ENVs in your shell.
+For the default environment variables, check out `Dockerfile`. We believe using ENVs this way is both consistent with the "cloud" ([12 Factor Pattern]({{< relref "development/12-factor-pattern.md" >}})) way of doing things, as well as a clear way of communicating what values are being passed without using a complicated convention. Additionally, you can set & forget these ENVs in your shell.
 
 # Layout Inside the Shell
 
@@ -24,4 +24,4 @@ We leverage as many semantics of the linux shell as we can to make the experienc
 | `/localhost`             | is where we house the local state (like your temporary AWS credentials). This is your native `$HOME` directory mounted into the container. |
 | `/s3`                    | is where we mount S3 buckets; these files are never written to disk and only kept in memory for security                                   |
 
-You can easily change almost any aspect of how the shell works simply by extending it with [Geodesic Module](doc:module)
+You can easily change almost any aspect of how the shell works simply by extending it with [Geodesic Module](/geodesic/module)

content/geodesic/module/quickstart.md

@@ -35,7 +35,7 @@ docker run -e CLUSTER_NAME \
 
 # Configure Project
 
-Customize module files as necessary. Edit the `Dockerfile` to reflect your settings. The files are installed to the `$CLUSTER_NAME/` folder. We recommend creating a [GitHub](doc:github) repo to store this configuration.
+Customize module files as necessary. Edit the `Dockerfile` to reflect your settings. The files are installed to the `$CLUSTER_NAME/` folder. We recommend creating a [GitHub]({{< relref "documentation/our-github.md" >}}) repo to store this configuration.
 
 ```
 cd $CLUSTER_NAME
@@ -64,7 +64,7 @@ make install
 ## Run the shell
 
 The shell can now be easily started any time by simply running `$CLUSTER_NAME`,  which is a shell script in `/usr/local/bin`. Make sure this path is in your `PATH` environment variable.
-For more information follow [Use](doc:use)
+For more information follow [Use](/geodesic/module/usage/)
 
 # Authorize on AWS
 

content/geodesic/module/usage/with-kops.md

@@ -8,7 +8,7 @@ excerpt: ""
 
 # Create a cluster
 
-Follow the [Provision a Cluster](doc:provision-a-cluster) process
+Follow the [Provision a Cluster]({{< relref "geodesic/module/usage/with-kops.md" >}}) process
 
 # Provision Platform Backing Services
 

content/geodesic/module/usage/with-terraform.md

@@ -29,7 +29,7 @@ Then run these commands:
 5. Re-run `init-terraform`, answer `yes` when asked to import state
 
 {{% dialog type="warning" icon="fa-exclamation-circle" title="Prerequisites" %}}
-Follow the "Use geodesic module"  to [Use](doc:use) get how to use the module shell.
+Follow the "Use geodesic module"  to [Use](/geodesic/module/usage/) get how to use the module shell.
 {{% /dialog %}}
 
 # Create terraform state bucket
@@ -120,13 +120,13 @@ ENV TF_VAR_tfstate_region=us-west-2
 ```
 
 ## Rebuild module
-[Rebuild](doc:use) the module
+[Rebuild](/geodesic/module/usage/) the module
 ```bash
 > make build
 ```
 
 ##  Run into the module shell
-Run Geodesic Shell in [development mode](doc:use#section-development-mode)
+Run Geodesic Shell in [development mode](/geodesic/module/usage/#section-development-mode)
 ```bash
 > $CLUSTER_NAME
 ```
@@ -250,13 +250,13 @@ ENV TF_DYNAMODB_TABLE "example-staging-terraform-state-lock"
 ```
 
 ## Rebuild the module
-[Rebuild](doc:use) the module
+[Rebuild](/geodesic/module/usage/) the module
 ```bash
 > make build
 ```
 
 ##  Run into the module shell and authorize on AWS
-Run Geodesic Shell in [development mode](doc:use#section-development-mode)
+Run Geodesic Shell in [development mode](/geodesic/module/usage/#section-development-mode)
 ```bash
 > $CLUSTER_NAME
 > assume-role

content/glossary/12-factor.md

@@ -0,0 +1,11 @@
+---
+title: 12-Factor
+terms: 
+- "12f"
+- "12-factor"
+- "12 factor"
+- "12 factor pattern"
+- "12-factor pattern"
+excerpt: ""
+---
+The 12 Factor Pattern is a software methodology for building cloud-friendly (or cloud-native), scalable, maintainable applications that deploy easily on a Platform-as-a-Service (aka PaaS).

content/glossary/paas.md

@@ -0,0 +1,9 @@
+---
+title: Platform-as-a-Service (PaaS)
+terms: 
+- "PaaS"
+- "Platform as a Service"
+- "Platform-as-a-Service"
+excerpt: ""
+---
+A Platform-as-a-Service is a type of cloud platform which offers black-box services that enable developers to build applications on top of the compute infrastructure without needing to deal with the day-to-day maintenance of the infrastructure. This might include developer tools that are offered as a service to build services, or data access and database services, or billing services.

content/glossary/saas.md

@@ -0,0 +1,11 @@
+---
+title: Software-as-a-Service (SaaS)
+terms: 
+- "SaaS"
+- "Software as a Service"
+- "Software-as-a-Service"
+excerpt: ""
+---
+Sofware-as-a-Service is a form of a cloud services platform, whereby the computing platform (operating system and associated services) is delivered as a service over the Internet by the provider. 
+
+