diff --git a/docs/content/configuration/download.md b/docs/content/configuration/download.md
index 69cf2e36..8f4fb17d 100644
--- a/docs/content/configuration/download.md
+++ b/docs/content/configuration/download.md
@@ -90,7 +90,7 @@ download "bad/module/repo/*" {
 
 ### Preventing storage overflow
 
-If you are running Athens using a [storage backend](./storage) that has limited space, you may want to prevent Athens from storing certain groups of modules that take up a lot of space. To avoid exhausting Athens storage, while still ensuring that the users of your Athens server still get access to the modules you can't store, you would use a `redirect` directive, as shown below:
+If you are running Athens using a [storage backend](/configuration/storage) that has limited space, you may want to prevent Athens from storing certain groups of modules that take up a lot of space. To avoid exhausting Athens storage, while still ensuring that the users of your Athens server still get access to the modules you can't store, you would use a `redirect` directive, as shown below:
 
 ```hcl
 download "very/large/*" {
diff --git a/docs/content/configuration/storage.md b/docs/content/configuration/storage.md
index 177fe23f..22716600 100644
--- a/docs/content/configuration/storage.md
+++ b/docs/content/configuration/storage.md
@@ -29,6 +29,11 @@ The Athens proxy supports many storage types:
       - [Configuration:](#configuration-8)
 - [External Storage](#external-storage)
       - [Configuration:](#configuration-9)
+- [Running multiple Athens pointed at the same storage](#running-multiple-athens-pointed-at-the-same-storage)
+  - [Using etcd as the single flight mechanism](#using-etcd-as-the-single-flight-mechanism)
+  - [Using redis as the single flight mechanism](#using-redis-as-the-single-flight-mechanism)
+    - [Direct connection to redis](#direct-connection-to-redis)
+    - [Connecting to redis via redis sentinel](#connecting-to-redis-via-redis-sentinel)
 
 All of them can be configured using `config.toml` file. You need to set a valid driver in `StorageType` value or you can set it in environment variable `ATHENS_STORAGE_TYPE` on your server.
 Also for most of the drivers you need to provide additional configuration data which will be described below.
@@ -49,7 +54,7 @@ This storage doesn't need any specific configuration and it's also used by defau
 
 Disk storage allows modules to be stored on a file system. The location on disk where modules will be stored can be configured.
 
->You can pre-fill disk-based storage to enable Athens deployments that have no access to the internet. See [here](./prefill-disk-cache) for instructions on how to do that.
+>You can pre-fill disk-based storage to enable Athens deployments that have no access to the internet. See [here](/configuration/prefill-disk-cache) for instructions on how to do that.
 
 ##### Configuration:
 
diff --git a/docs/content/contributing/new/docs.md b/docs/content/contributing/new/docs.md
index edbedd05..6ac71282 100644
--- a/docs/content/contributing/new/docs.md
+++ b/docs/content/contributing/new/docs.md
@@ -16,4 +16,4 @@ Contributing to docs is just as important, if not more important than, writing c
 
 The Hugo server will run on http://localhost:1313 and it will automatically watch your files and update the website every time you make a change. 
 
-Alternatively you can run our custom docker image as outlined [here](./DEVELOPMENT.md#run-the-docs)
\ No newline at end of file
+Alternatively you can run our custom docker image as outlined [here](https://github.com/gomods/athens/blob/main/DEVELOPMENT.md#build-the-docs)
\ No newline at end of file
diff --git a/docs/content/install/using-docker.md b/docs/content/install/using-docker.md
index c5ac1186..99deaf93 100644
--- a/docs/content/install/using-docker.md
+++ b/docs/content/install/using-docker.md
@@ -4,7 +4,7 @@ description: Information about Athens' Docker images
 weight: 1
 ---
 
-Whether setting Athens up using [Kubernetes](./install-on-kubernetes) or using the [Walkthrough](/Walkthrough), you'll most likely be using one of the images that the Athens project produces. This document details what images are available, and has a recap from the Walkthrough of how to use them on their own.
+Whether setting Athens up using [Kubernetes](install/install-on-kubernetes/) or using the [Walkthrough](/Walkthrough), you'll most likely be using one of the images that the Athens project produces. This document details what images are available, and has a recap from the Walkthrough of how to use them on their own.
 
 ---