chore(*) merge public repo (#211)

Kong · Jan 28, 2019 · 0362ad5 · 0362ad5
1 parent 3d99dfc
commit 0362ad5
Show file tree

Hide file tree

Showing 1,085 changed files with 28,038 additions and 1,313 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,6 +2,7 @@
 > contribute to Kong itself, then please go
 > [here](https://github.com/Kong/kong/blob/master/CONTRIBUTING.md).
 
+
 # Contributing to docs.konghq.com 📜 🦍
 
 Hello, and welcome! Whether you are looking for help, trying to report a bug,
@@ -27,6 +28,7 @@ Consult the Table of Contents below, and jump to the desired section.
   - [Table of Contents generator](#table-of-contents-generator)
   - [Contributor T-shirt](#contributor-t-shirt)
 
+
 ## Where to seek help?
 
 Consult the [Kong Contributing
@@ -123,8 +125,7 @@ a build, which should generally happen right after your patch was merged.
 
 If you are planning on producing a new Kong plugin or integration, with the
 intent to list it in the Kong Hub, you are encouraged to have a quick
-call with Kong's Director of Ecosystem, Cooper Marcus -
-[book a time](http://meetme.so/cooper), or email him at [email protected].
+chat with Kong's CTO, Marco Palladino - email him at [email protected].
 
 Adding a new listing to the Kong Hub may be proposed by:
 
@@ -145,7 +146,7 @@ documenting a Kong plugin, be sure to see the next section.
 `/app/_assets/images/icons/hub/` - the filename of your image should be
 `publisher_extension` using the "publisher" and "extension" name from step 2.
 Custom logos are optional. If you don't have a custom logo, please duplicate
-an existing default logo file, and rename it as noted above. 
+an existing default logo file, and rename it as noted above.
 1. Be sure to run the docs site locally per the instructions in
 the README - you should find your Hub contribution listed at
 `localhost:3000/hub`
@@ -157,6 +158,7 @@ necessary, and once approved, will merge and deploy your Kong Hub addition!
 
 [Back to TOC](#table-of-contents)
 
+
 ### Writing plugin documentation
 
 Plugins are documented as extensions under `app/_hub/` - please look at
@@ -199,6 +201,7 @@ the existing plugins for examples, and see additional advice in
 
 [Back to TOC](#table-of-contents)
 
+
 #### Git branches
 
 In this repository, `master` represents the current state of the website, and
@@ -346,6 +349,7 @@ Instead, please:
 
 [Back to TOC](#table-of-contents)
 
+
 ### Table of Contents generator
 
 Almost all pages have an automatic Table of Contents (ToC) added to the top of
@@ -374,17 +378,17 @@ will cause a broken ToC, and should be corrected to:
 ### Sub-sub-heading Level 3
 ```
 
-### Contributor T-shirt
+[Back to TOC](#table-of-contents)
 
-If your Pull Request to
-[Kong/docs.konghq.com](https://github.com/Kong/docs.konghq.com) was accepted,
-congratulations, you are eligible to receive the very special Contributor
-T-shirt! Go ahead and fill-out the [Contributors Submissions
-form](https://goo.gl/forms/5w6mxLaE4tz2YM0L2).
 
-Proudly wear your T-shirt and show it to us by tagging
-[@thekonginc](https://twitter.com/thekonginc) on Twitter!
+### Contributor T-shirt
+
+If your contribution to this repository was accepted and fixes a bug, adds
+functionality, or makes it significantly easier to use or understand Kong,
+congratulations! You are eligible to receive the very special Contributor
+T-shirt! Find out how to request your shirt
+[here](https://github.com/Kong/kong/blob/master/CONTRIBUTING.md#contributor-t-shirt).
 
-![Kong Contributor T-shirt](https://konghq.com/wp-content/uploads/2018/04/100-contributor-t-shirt-1024x768.jpg)
+Thank you for contributing!
 
 [Back to TOC](#table-of-contents)
diff --git a/Dockerfile b/Dockerfile
diff --git a/Gemfile b/Gemfile
diff --git a/LICENSE b/LICENSE
diff --git a/Makefile b/Makefile
diff --git a/README.md b/README.md
@@ -67,6 +67,25 @@ scraper to test out config changes.
   * Generate documentation for all the modules in your PDK (where possible) and
     put in a folder inside your version docs
 
+## Generating the Admin API and CLI Documentation
+
+- Make sure that the `resty` and `luajit` executables are in your `$PATH` (installing kong should install them)
+- Several Lua rocks are needed. Easiest way to get all of them is to execute `make dev` in the Kong folder
+- Have a local clone of Kong
+- In the Kong repository, checkout the desired branch/tag/release
+- To generate the Admin API docs:
+  - Run: `KONG_PATH=path/to/your/kong/folder KONG_VERSION=0.14.x gulp admin-api-docs`
+  - This command will attempt to:
+    * Compare Kong's schemas and Admin API routes with the contents of the file
+      `autodoc-admin-api/data.lua` and error out if there's any mismatches or missing data.
+    * If no errors were found, a new `admin-api.md` file will be generated in the path corresponding
+      to the provided KONG_VERSION.
+- To generate the CLI docs:
+  - Run: `KONG_PATH=path/to/your/kong/folder KONG_VERSION=0.14.x gulp cli-docs`
+  - This command will:
+    * Extract the output of the `--help` for every `kong` CLI subcommand
+    * Generate a new `cli.md` in the path corresponding to the provided KONG_VERSION.
+
 ## Listing Your Extension in the Kong Hub
 
 We encourage developers to list their Kong plugins and integrations (which

diff --git a/app/0.10.x/admin-api.md b/app/0.10.x/admin-api.md
diff --git a/app/0.10.x/auth.md b/app/0.10.x/auth.md
diff --git a/app/0.10.x/cli.md b/app/0.10.x/cli.md
diff --git a/app/0.10.x/clustering.md b/app/0.10.x/clustering.md
diff --git a/app/0.10.x/configuration.md b/app/0.10.x/configuration.md
diff --git a/app/0.10.x/getting-started/adding-consumers.md b/app/0.10.x/getting-started/adding-consumers.md
diff --git a/app/0.10.x/getting-started/adding-your-api.md b/app/0.10.x/getting-started/adding-your-api.md
diff --git a/app/0.10.x/getting-started/enabling-plugins.md b/app/0.10.x/getting-started/enabling-plugins.md
diff --git a/app/0.10.x/getting-started/introduction.md b/app/0.10.x/getting-started/introduction.md
diff --git a/app/0.10.x/getting-started/quickstart.md b/app/0.10.x/getting-started/quickstart.md
diff --git a/app/0.10.x/index.md b/app/0.10.x/index.md
diff --git a/app/0.10.x/loadbalancing.md b/app/0.10.x/loadbalancing.md
diff --git a/app/0.10.x/lua-reference/index.html b/app/0.10.x/lua-reference/index.html
diff --git a/app/0.10.x/lua-reference/modules/kong.dao.html b/app/0.10.x/lua-reference/modules/kong.dao.html
diff --git a/app/0.10.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html b/app/0.10.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html
diff --git a/app/0.10.x/lua-reference/modules/kong.plugins.galileo.alf.html b/app/0.10.x/lua-reference/modules/kong.plugins.galileo.alf.html
diff --git a/app/0.10.x/lua-reference/modules/kong.plugins.galileo.buffer.html b/app/0.10.x/lua-reference/modules/kong.plugins.galileo.buffer.html
diff --git a/app/0.10.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html b/app/0.10.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html
diff --git a/app/0.10.x/lua-reference/modules/kong.tools.responses.html b/app/0.10.x/lua-reference/modules/kong.tools.responses.html
diff --git a/app/0.10.x/lua-reference/modules/kong.tools.timestamp.html b/app/0.10.x/lua-reference/modules/kong.tools.timestamp.html
diff --git a/app/0.10.x/lua-reference/modules/kong.tools.utils.html b/app/0.10.x/lua-reference/modules/kong.tools.utils.html
diff --git a/app/0.10.x/lua-reference/modules/spec.helpers.html b/app/0.10.x/lua-reference/modules/spec.helpers.html
diff --git a/app/0.10.x/network.md b/app/0.10.x/network.md
diff --git a/app/0.10.x/plugin-development/access-the-datastore.md b/app/0.10.x/plugin-development/access-the-datastore.md
diff --git a/app/0.10.x/plugin-development/admin-api.md b/app/0.10.x/plugin-development/admin-api.md
diff --git a/app/0.10.x/plugin-development/custom-entities.md b/app/0.10.x/plugin-development/custom-entities.md
diff --git a/app/0.10.x/plugin-development/custom-logic.md b/app/0.10.x/plugin-development/custom-logic.md
diff --git a/app/0.10.x/plugin-development/distribution.md b/app/0.10.x/plugin-development/distribution.md
diff --git a/app/0.10.x/plugin-development/entities-cache.md b/app/0.10.x/plugin-development/entities-cache.md
diff --git a/app/0.10.x/plugin-development/file-structure.md b/app/0.10.x/plugin-development/file-structure.md
diff --git a/app/0.10.x/plugin-development/index.md b/app/0.10.x/plugin-development/index.md
diff --git a/app/0.10.x/plugin-development/plugin-configuration.md b/app/0.10.x/plugin-development/plugin-configuration.md
diff --git a/app/0.10.x/plugin-development/tests.md b/app/0.10.x/plugin-development/tests.md
diff --git a/app/0.10.x/proxy.md b/app/0.10.x/proxy.md
diff --git a/app/0.10.x/secure-admin-api.md b/app/0.10.x/secure-admin-api.md
diff --git a/app/0.11.x/admin-api.md b/app/0.11.x/admin-api.md
diff --git a/app/0.11.x/auth.md b/app/0.11.x/auth.md
diff --git a/app/0.11.x/cli.md b/app/0.11.x/cli.md
diff --git a/app/0.11.x/clustering.md b/app/0.11.x/clustering.md
diff --git a/app/0.11.x/configuration.md b/app/0.11.x/configuration.md
diff --git a/app/0.11.x/getting-started/adding-consumers.md b/app/0.11.x/getting-started/adding-consumers.md
diff --git a/app/0.11.x/getting-started/adding-your-api.md b/app/0.11.x/getting-started/adding-your-api.md
diff --git a/app/0.11.x/getting-started/enabling-plugins.md b/app/0.11.x/getting-started/enabling-plugins.md
diff --git a/app/0.11.x/getting-started/introduction.md b/app/0.11.x/getting-started/introduction.md
diff --git a/app/0.11.x/getting-started/quickstart.md b/app/0.11.x/getting-started/quickstart.md
@@ -17,32 +17,32 @@ supports PostgreSQL and Cassandra).
 
 ## 1. Start Kong
 
-    Issue the following command to prepare your datastore by running the Kong
-    migrations:
+Issue the following command to prepare your datastore by running the Kong
+migrations:
 
-    ```bash
-    $ kong migrations up [-c /path/to/kong.conf]
-    ```
+```bash
+$ kong migrations up [-c /path/to/kong.conf]
+```
 
-    You should see a message that tells you Kong has successfully migrated your
-    database. If not, you probably incorrectly configured your database
-    connection settings in your configuration file.
+You should see a message that tells you Kong has successfully migrated your
+database. If not, you probably incorrectly configured your database
+connection settings in your configuration file.
 
-    Now let's [start][CLI] Kong:
+Now let's [start][CLI] Kong:
 
-    ```bash
-    $ kong start [-c /path/to/kong.conf]
-    ```
+```bash
+$ kong start [-c /path/to/kong.conf]
+```
 
-    **Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
-    allowing you to point to your own configuration.
+**Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
+allowing you to point to [your own configuration][configuration-loading].
 
 ## 2. Verify that Kong has started successfully
 
-    If everything went well, you should see a message (`Kong started`)
-    informing you that Kong is running.
+If everything went well, you should see a message (`Kong started`)
+informing you that Kong is running.
 
-    By default Kong listens on the following ports:
+By default Kong listens on the following ports:
 
 - `:8000` on which Kong listens for incoming HTTP traffic from your
   clients, and forwards it to your upstream services.
@@ -54,27 +54,28 @@ supports PostgreSQL and Cassandra).
 
 ## 3. Stop Kong
 
-    As needed you can stop the Kong process by issuing the following
-    [command][CLI]:
+As needed you can stop the Kong process by issuing the following
+[command][CLI]:
 
-    ```bash
-    $ kong stop
-    ```
+```bash
+$ kong stop
+```
 
 ## 4. Reload Kong
 
-    Issue the following command to [reload][CLI] Kong without downtime:
+Issue the following command to [reload][CLI] Kong without downtime:
 
-    ```bash
-    $ kong reload
-    ```
+```bash
+$ kong reload
+```
 
 ## Next Steps
 
 Now that you have Kong running you can interact with the Admin API.
 
 To begin, go to [Adding your API &rsaquo;][adding-your-api]
 
+[configuration-loading]: /{{page.kong_version}}/configuration/#configuration-loading
 [CLI]: /{{page.kong_version}}/cli
 [API]: /{{page.kong_version}}/admin-api
 [datastore-section]: /{{page.kong_version}}/configuration/#datastore-section

diff --git a/app/0.11.x/index.md b/app/0.11.x/index.md
diff --git a/app/0.11.x/loadbalancing.md b/app/0.11.x/loadbalancing.md
diff --git a/app/0.11.x/lua-reference/index.html b/app/0.11.x/lua-reference/index.html
diff --git a/app/0.11.x/lua-reference/modules/kong.dao.html b/app/0.11.x/lua-reference/modules/kong.dao.html
diff --git a/app/0.11.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html b/app/0.11.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html
diff --git a/app/0.11.x/lua-reference/modules/kong.plugins.galileo.alf.html b/app/0.11.x/lua-reference/modules/kong.plugins.galileo.alf.html
diff --git a/app/0.11.x/lua-reference/modules/kong.plugins.galileo.buffer.html b/app/0.11.x/lua-reference/modules/kong.plugins.galileo.buffer.html
diff --git a/app/0.11.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html b/app/0.11.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html
diff --git a/app/0.11.x/lua-reference/modules/kong.tools.responses.html b/app/0.11.x/lua-reference/modules/kong.tools.responses.html
diff --git a/app/0.11.x/lua-reference/modules/kong.tools.timestamp.html b/app/0.11.x/lua-reference/modules/kong.tools.timestamp.html
diff --git a/app/0.11.x/lua-reference/modules/kong.tools.utils.html b/app/0.11.x/lua-reference/modules/kong.tools.utils.html
diff --git a/app/0.11.x/lua-reference/modules/spec.helpers.html b/app/0.11.x/lua-reference/modules/spec.helpers.html
diff --git a/app/0.11.x/network.md b/app/0.11.x/network.md
diff --git a/app/0.11.x/plugin-development/access-the-datastore.md b/app/0.11.x/plugin-development/access-the-datastore.md
diff --git a/app/0.11.x/plugin-development/admin-api.md b/app/0.11.x/plugin-development/admin-api.md
diff --git a/app/0.11.x/plugin-development/custom-entities.md b/app/0.11.x/plugin-development/custom-entities.md
diff --git a/app/0.11.x/plugin-development/custom-logic.md b/app/0.11.x/plugin-development/custom-logic.md
diff --git a/app/0.11.x/plugin-development/distribution.md b/app/0.11.x/plugin-development/distribution.md
diff --git a/app/0.11.x/plugin-development/entities-cache.md b/app/0.11.x/plugin-development/entities-cache.md
diff --git a/app/0.11.x/plugin-development/file-structure.md b/app/0.11.x/plugin-development/file-structure.md
diff --git a/app/0.11.x/plugin-development/index.md b/app/0.11.x/plugin-development/index.md
diff --git a/app/0.11.x/plugin-development/plugin-configuration.md b/app/0.11.x/plugin-development/plugin-configuration.md
diff --git a/app/0.11.x/plugin-development/tests.md b/app/0.11.x/plugin-development/tests.md
diff --git a/app/0.11.x/proxy.md b/app/0.11.x/proxy.md
diff --git a/app/0.11.x/secure-admin-api.md b/app/0.11.x/secure-admin-api.md
diff --git a/app/0.12.x/admin-api.md b/app/0.12.x/admin-api.md
diff --git a/app/0.12.x/auth.md b/app/0.12.x/auth.md
diff --git a/app/0.12.x/cli.md b/app/0.12.x/cli.md
diff --git a/app/0.12.x/clustering.md b/app/0.12.x/clustering.md
diff --git a/app/0.12.x/configuration.md b/app/0.12.x/configuration.md
diff --git a/app/0.12.x/getting-started/adding-consumers.md b/app/0.12.x/getting-started/adding-consumers.md
diff --git a/app/0.12.x/getting-started/adding-your-api.md b/app/0.12.x/getting-started/adding-your-api.md
diff --git a/app/0.12.x/getting-started/enabling-plugins.md b/app/0.12.x/getting-started/enabling-plugins.md
diff --git a/app/0.12.x/getting-started/introduction.md b/app/0.12.x/getting-started/introduction.md
diff --git a/app/0.12.x/getting-started/quickstart.md b/app/0.12.x/getting-started/quickstart.md
@@ -17,32 +17,32 @@ supports PostgreSQL and Cassandra).
 
 ## 1. Start Kong
 
-    Issue the following command to prepare your datastore by running the Kong
-    migrations:
+Issue the following command to prepare your datastore by running the Kong
+migrations:
 
-    ```bash
-    $ kong migrations up [-c /path/to/kong.conf]
-    ```
+```bash
+$ kong migrations up [-c /path/to/kong.conf]
+```
 
-    You should see a message that tells you Kong has successfully migrated your
-    database. If not, you probably incorrectly configured your database
-    connection settings in your configuration file.
+You should see a message that tells you Kong has successfully migrated your
+database. If not, you probably incorrectly configured your database
+connection settings in your configuration file.
 
-    Now let's [start][CLI] Kong:
+Now let's [start][CLI] Kong:
 
-    ```bash
-    $ kong start [-c /path/to/kong.conf]
-    ```
+```bash
+$ kong start [-c /path/to/kong.conf]
+```
 
-    **Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
-    allowing you to point to your own configuration.
+**Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
+allowing you to point to [your own configuration][configuration-loading].
 
 ## 2. Verify that Kong has started successfully
 
-    If everything went well, you should see a message (`Kong started`)
-    informing you that Kong is running.
+If everything went well, you should see a message (`Kong started`)
+informing you that Kong is running.
 
-    By default Kong listens on the following ports:
+By default Kong listens on the following ports:
 
 - `:8000` on which Kong listens for incoming HTTP traffic from your
   clients, and forwards it to your upstream services.
@@ -54,27 +54,28 @@ supports PostgreSQL and Cassandra).
 
 ## 3. Stop Kong
 
-    As needed you can stop the Kong process by issuing the following
-    [command][CLI]:
+As needed you can stop the Kong process by issuing the following
+[command][CLI]:
 
-    ```bash
-    $ kong stop
-    ```
+```bash
+$ kong stop
+```
 
 ## 4. Reload Kong
 
-    Issue the following command to [reload][CLI] Kong without downtime:
+Issue the following command to [reload][CLI] Kong without downtime:
 
-    ```bash
-    $ kong reload
-    ```
+```bash
+$ kong reload
+```
 
 ## Next Steps
 
 Now that you have Kong running you can interact with the Admin API.
 
 To begin, go to [Adding your API &rsaquo;][adding-your-api]
 
+[configuration-loading]: /{{page.kong_version}}/configuration/#configuration-loading
 [CLI]: /{{page.kong_version}}/cli
 [API]: /{{page.kong_version}}/admin-api
 [datastore-section]: /{{page.kong_version}}/configuration/#datastore-section

diff --git a/app/0.12.x/health-checks-circuit-breakers.md b/app/0.12.x/health-checks-circuit-breakers.md
diff --git a/app/0.12.x/index.md b/app/0.12.x/index.md
diff --git a/app/0.12.x/loadbalancing.md b/app/0.12.x/loadbalancing.md
diff --git a/app/0.12.x/lua-reference/index.html b/app/0.12.x/lua-reference/index.html
diff --git a/app/0.12.x/lua-reference/modules/kong.dao.html b/app/0.12.x/lua-reference/modules/kong.dao.html
diff --git a/app/0.12.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html b/app/0.12.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html
diff --git a/app/0.12.x/lua-reference/modules/kong.plugins.galileo.alf.html b/app/0.12.x/lua-reference/modules/kong.plugins.galileo.alf.html
diff --git a/app/0.12.x/lua-reference/modules/kong.plugins.galileo.buffer.html b/app/0.12.x/lua-reference/modules/kong.plugins.galileo.buffer.html
diff --git a/app/0.12.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html b/app/0.12.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html
diff --git a/app/0.12.x/lua-reference/modules/kong.tools.responses.html b/app/0.12.x/lua-reference/modules/kong.tools.responses.html
diff --git a/app/0.12.x/lua-reference/modules/kong.tools.timestamp.html b/app/0.12.x/lua-reference/modules/kong.tools.timestamp.html
diff --git a/app/0.12.x/lua-reference/modules/kong.tools.utils.html b/app/0.12.x/lua-reference/modules/kong.tools.utils.html
diff --git a/app/0.12.x/lua-reference/modules/spec.helpers.html b/app/0.12.x/lua-reference/modules/spec.helpers.html
diff --git a/app/0.12.x/network.md b/app/0.12.x/network.md
diff --git a/app/0.12.x/plugin-development/access-the-datastore.md b/app/0.12.x/plugin-development/access-the-datastore.md
diff --git a/app/0.12.x/plugin-development/admin-api.md b/app/0.12.x/plugin-development/admin-api.md
diff --git a/app/0.12.x/plugin-development/custom-entities.md b/app/0.12.x/plugin-development/custom-entities.md
diff --git a/app/0.12.x/plugin-development/custom-logic.md b/app/0.12.x/plugin-development/custom-logic.md
diff --git a/app/0.12.x/plugin-development/distribution.md b/app/0.12.x/plugin-development/distribution.md
diff --git a/app/0.12.x/plugin-development/entities-cache.md b/app/0.12.x/plugin-development/entities-cache.md
diff --git a/app/0.12.x/plugin-development/file-structure.md b/app/0.12.x/plugin-development/file-structure.md
diff --git a/app/0.12.x/plugin-development/index.md b/app/0.12.x/plugin-development/index.md
diff --git a/app/0.12.x/plugin-development/plugin-configuration.md b/app/0.12.x/plugin-development/plugin-configuration.md
diff --git a/app/0.12.x/plugin-development/tests.md b/app/0.12.x/plugin-development/tests.md
diff --git a/app/0.12.x/proxy.md b/app/0.12.x/proxy.md
diff --git a/app/0.12.x/secure-admin-api.md b/app/0.12.x/secure-admin-api.md
diff --git a/app/0.13.x/admin-api.md b/app/0.13.x/admin-api.md
diff --git a/app/0.13.x/auth.md b/app/0.13.x/auth.md
diff --git a/app/0.13.x/cli.md b/app/0.13.x/cli.md
diff --git a/app/0.13.x/clustering.md b/app/0.13.x/clustering.md
diff --git a/app/0.13.x/configuration.md b/app/0.13.x/configuration.md
diff --git a/app/0.13.x/getting-started/adding-consumers.md b/app/0.13.x/getting-started/adding-consumers.md
diff --git a/app/0.13.x/getting-started/configuring-a-service.md b/app/0.13.x/getting-started/configuring-a-service.md
diff --git a/app/0.13.x/getting-started/enabling-plugins.md b/app/0.13.x/getting-started/enabling-plugins.md
diff --git a/app/0.13.x/getting-started/introduction.md b/app/0.13.x/getting-started/introduction.md
diff --git a/app/0.13.x/getting-started/quickstart.md b/app/0.13.x/getting-started/quickstart.md
@@ -17,32 +17,32 @@ supports PostgreSQL and Cassandra).
 
 ## 1. Start Kong
 
-    Issue the following command to prepare your datastore by running the Kong
-    migrations:
+Issue the following command to prepare your datastore by running the Kong
+migrations:
 
-    ```bash
-    $ kong migrations up [-c /path/to/kong.conf]
-    ```
+```bash
+$ kong migrations up [-c /path/to/kong.conf]
+```
 
-    You should see a message that tells you Kong has successfully migrated your
-    database. If not, you probably incorrectly configured your database
-    connection settings in your configuration file.
+You should see a message that tells you Kong has successfully migrated your
+database. If not, you probably incorrectly configured your database
+connection settings in your configuration file.
 
-    Now let's [start][CLI] Kong:
+Now let's [start][CLI] Kong:
 
-    ```bash
-    $ kong start [-c /path/to/kong.conf]
-    ```
+```bash
+$ kong start [-c /path/to/kong.conf]
+```
 
-    **Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
-    allowing you to point to your own configuration.
+**Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
+allowing you to point to [your own configuration][configuration-loading].
 
 ## 2. Verify that Kong has started successfully
 
-    If everything went well, you should see a message (`Kong started`)
-    informing you that Kong is running.
+If everything went well, you should see a message (`Kong started`)
+informing you that Kong is running.
 
-    By default Kong listens on the following ports:
+By default Kong listens on the following ports:
 
 - `:8000` on which Kong listens for incoming HTTP traffic from your
   clients, and forwards it to your upstream services.
@@ -54,27 +54,28 @@ supports PostgreSQL and Cassandra).
 
 ## 3. Stop Kong
 
-    As needed you can stop the Kong process by issuing the following
-    [command][CLI]:
+As needed you can stop the Kong process by issuing the following
+[command][CLI]:
 
-    ```bash
-    $ kong stop
-    ```
+```bash
+$ kong stop
+```
 
 ## 4. Reload Kong
 
-    Issue the following command to [reload][CLI] Kong without downtime:
+Issue the following command to [reload][CLI] Kong without downtime:
 
-    ```bash
-    $ kong reload
-    ```
+```bash
+$ kong reload
+```
 
 ## Next Steps
 
 Now that you have Kong running you can interact with the Admin API.
 
 To begin, go to [Configuring a Service &rsaquo;][configuring-a-service]
 
+[configuration-loading]: /{{page.kong_version}}/configuration/#configuration-loading
 [CLI]: /{{page.kong_version}}/cli
 [API]: /{{page.kong_version}}/admin-api
 [datastore-section]: /{{page.kong_version}}/configuration/#datastore-section

diff --git a/app/0.13.x/health-checks-circuit-breakers.md b/app/0.13.x/health-checks-circuit-breakers.md
diff --git a/app/0.13.x/index.md b/app/0.13.x/index.md
diff --git a/app/0.13.x/loadbalancing.md b/app/0.13.x/loadbalancing.md
diff --git a/app/0.13.x/lua-reference/index.html b/app/0.13.x/lua-reference/index.html
diff --git a/app/0.13.x/lua-reference/modules/kong.dao.html b/app/0.13.x/lua-reference/modules/kong.dao.html
diff --git a/app/0.13.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html b/app/0.13.x/lua-reference/modules/kong.plugins.basic-auth.crypto.html
diff --git a/app/0.13.x/lua-reference/modules/kong.plugins.galileo.alf.html b/app/0.13.x/lua-reference/modules/kong.plugins.galileo.alf.html
diff --git a/app/0.13.x/lua-reference/modules/kong.plugins.galileo.buffer.html b/app/0.13.x/lua-reference/modules/kong.plugins.galileo.buffer.html
diff --git a/app/0.13.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html b/app/0.13.x/lua-reference/modules/kong.plugins.jwt.jwt_parser.html
diff --git a/app/0.13.x/lua-reference/modules/kong.tools.responses.html b/app/0.13.x/lua-reference/modules/kong.tools.responses.html
diff --git a/app/0.13.x/lua-reference/modules/kong.tools.timestamp.html b/app/0.13.x/lua-reference/modules/kong.tools.timestamp.html
diff --git a/app/0.13.x/lua-reference/modules/kong.tools.utils.html b/app/0.13.x/lua-reference/modules/kong.tools.utils.html
diff --git a/app/0.13.x/lua-reference/modules/spec.helpers.html b/app/0.13.x/lua-reference/modules/spec.helpers.html
diff --git a/app/0.13.x/network.md b/app/0.13.x/network.md
diff --git a/app/0.13.x/plugin-development/access-the-datastore.md b/app/0.13.x/plugin-development/access-the-datastore.md
diff --git a/app/0.13.x/plugin-development/admin-api.md b/app/0.13.x/plugin-development/admin-api.md
diff --git a/app/0.13.x/plugin-development/custom-entities.md b/app/0.13.x/plugin-development/custom-entities.md
diff --git a/app/0.13.x/plugin-development/custom-logic.md b/app/0.13.x/plugin-development/custom-logic.md
diff --git a/app/0.13.x/plugin-development/distribution.md b/app/0.13.x/plugin-development/distribution.md
diff --git a/app/0.13.x/plugin-development/entities-cache.md b/app/0.13.x/plugin-development/entities-cache.md
diff --git a/app/0.13.x/plugin-development/file-structure.md b/app/0.13.x/plugin-development/file-structure.md
diff --git a/app/0.13.x/plugin-development/index.md b/app/0.13.x/plugin-development/index.md
diff --git a/app/0.13.x/plugin-development/plugin-configuration.md b/app/0.13.x/plugin-development/plugin-configuration.md
diff --git a/app/0.13.x/plugin-development/tests.md b/app/0.13.x/plugin-development/tests.md
diff --git a/app/0.13.x/proxy.md b/app/0.13.x/proxy.md
diff --git a/app/0.13.x/secure-admin-api.md b/app/0.13.x/secure-admin-api.md
diff --git a/app/0.14.x/admin-api.md b/app/0.14.x/admin-api.md
diff --git a/app/0.14.x/auth.md b/app/0.14.x/auth.md
diff --git a/app/0.14.x/cli.md b/app/0.14.x/cli.md
diff --git a/app/0.14.x/clustering.md b/app/0.14.x/clustering.md
diff --git a/app/0.14.x/configuration.md b/app/0.14.x/configuration.md
diff --git a/app/0.14.x/getting-started/adding-consumers.md b/app/0.14.x/getting-started/adding-consumers.md
diff --git a/app/0.14.x/getting-started/configuring-a-service.md b/app/0.14.x/getting-started/configuring-a-service.md
diff --git a/app/0.14.x/getting-started/enabling-plugins.md b/app/0.14.x/getting-started/enabling-plugins.md
diff --git a/app/0.14.x/getting-started/introduction.md b/app/0.14.x/getting-started/introduction.md
diff --git a/app/0.14.x/getting-started/quickstart.md b/app/0.14.x/getting-started/quickstart.md
@@ -33,7 +33,7 @@ $ kong start [-c /path/to/kong.conf]
 ```
 
 **Note:** the CLI accepts a configuration option (`-c /path/to/kong.conf`)
-allowing you to point to your own configuration.
+allowing you to point to [your own configuration][configuration-loading].
 
 [Back to TOC](#table-of-contents)
 
@@ -81,6 +81,7 @@ Now that you have Kong running you can interact with the Admin API.
 
 To begin, go to [Configuring a Service &rsaquo;][configuring-a-service]
 
+[configuration-loading]: /{{page.kong_version}}/configuration/#configuration-loading
 [CLI]: /{{page.kong_version}}/cli
 [API]: /{{page.kong_version}}/admin-api
 [datastore-section]: /{{page.kong_version}}/configuration/#datastore-section

diff --git a/app/0.14.x/health-checks-circuit-breakers.md b/app/0.14.x/health-checks-circuit-breakers.md
diff --git a/app/0.14.x/index.md b/app/0.14.x/index.md
diff --git a/app/0.14.x/loadbalancing.md b/app/0.14.x/loadbalancing.md
diff --git a/app/0.14.x/logging.md b/app/0.14.x/logging.md
diff --git a/app/0.14.x/network.md b/app/0.14.x/network.md
diff --git a/app/0.14.x/pdk/index.md b/app/0.14.x/pdk/index.md
diff --git a/app/0.14.x/pdk/kong.client.md b/app/0.14.x/pdk/kong.client.md
diff --git a/app/0.14.x/pdk/kong.ctx.md b/app/0.14.x/pdk/kong.ctx.md
diff --git a/app/0.14.x/pdk/kong.ip.md b/app/0.14.x/pdk/kong.ip.md
diff --git a/app/0.14.x/pdk/kong.log.md b/app/0.14.x/pdk/kong.log.md
diff --git a/app/0.14.x/pdk/kong.request.md b/app/0.14.x/pdk/kong.request.md
diff --git a/app/0.14.x/pdk/kong.response.md b/app/0.14.x/pdk/kong.response.md
diff --git a/app/0.14.x/pdk/kong.service.md b/app/0.14.x/pdk/kong.service.md
diff --git a/app/0.14.x/pdk/kong.service.request.md b/app/0.14.x/pdk/kong.service.request.md
diff --git a/app/0.14.x/pdk/kong.service.response.md b/app/0.14.x/pdk/kong.service.response.md
diff --git a/app/0.14.x/pdk/kong.table.md b/app/0.14.x/pdk/kong.table.md
diff --git a/app/0.14.x/plugin-development/access-the-datastore.md b/app/0.14.x/plugin-development/access-the-datastore.md
diff --git a/app/0.14.x/plugin-development/admin-api.md b/app/0.14.x/plugin-development/admin-api.md
diff --git a/app/0.14.x/plugin-development/custom-entities.md b/app/0.14.x/plugin-development/custom-entities.md
diff --git a/app/0.14.x/plugin-development/custom-logic.md b/app/0.14.x/plugin-development/custom-logic.md
diff --git a/app/0.14.x/plugin-development/distribution.md b/app/0.14.x/plugin-development/distribution.md
diff --git a/app/0.14.x/plugin-development/entities-cache.md b/app/0.14.x/plugin-development/entities-cache.md
diff --git a/app/0.14.x/plugin-development/file-structure.md b/app/0.14.x/plugin-development/file-structure.md
diff --git a/app/0.14.x/plugin-development/index.md b/app/0.14.x/plugin-development/index.md
diff --git a/app/0.14.x/plugin-development/plugin-configuration.md b/app/0.14.x/plugin-development/plugin-configuration.md
diff --git a/app/0.14.x/plugin-development/tests.md b/app/0.14.x/plugin-development/tests.md