diff --git a/README.md b/README.md
index 75761f5f4d..94b2b19da8 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@ breaking changes.
 ## Gaia Testnet
 
 To join the latest testnet, follow 
-[the guide](https://cosmos.network/docs/getting-started/full-node.html#setting-up-a-new-node).
+[the guide](./docs/getting-started/join-testnet.md).
 
 For status updates and genesis files, see the
 [testnets repo](https://github.com/cosmos/testnets).
@@ -30,15 +30,14 @@ For status updates and genesis files, see the
 ## Install
 
 See the 
-[install instructions](https://cosmos.network/docs/getting-started/installation.html).
+[install instructions](./docs/getting-started/installation.md).
 
 ## Quick Start
 
 See the [Cosmos Docs](https://cosmos.network/docs/)
 
-- [Getting started with the SDK](https://cosmos.network/docs/sdk/core/intro.html)
+- [Getting started with the SDK](./docs/sdk/core/intro.md)
 - [SDK Examples](/examples)
-- [Join the testnet](https://cosmos.network/docs/getting-started/full-node.html#run-a-full-node)
 
 ## Disambiguation
 
diff --git a/docs/README.md b/docs/README.md
index 2edcebe8db..13b831f393 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -10,9 +10,9 @@ Cosmos can interoperate with multiple other applications and cryptocurrencies. B
 
 ## Quick Start
 
-- [Getting started with the SDK](./sdk/core/intro.html)
+- [Getting started with the SDK](./sdk/core/intro.md)
 - [SDK Examples](../examples)
-- [Join the testnet](./getting-started/full-node.html#run-a-full-node)
+- [Join the testnet](./getting-started/join-testnet.md#run-a-full-node)
 
 ## Edit the Documentation
 
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index c23f3b02cd..66ccae4b85 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -1,6 +1,6 @@
 # Install the SDK
 
-This guide will explain how to install the [Cosmos SDK](/sdk/overview.md) onto your system. With the SDK installed on a server, you can participate in the latest testnet as either a [Full Node](full-node.md) or a [Validator](/validators/validator-setup.md).
+This guide will explain how to install the [Cosmos SDK](/sdk/overview.md) onto your system. With the SDK installed on a server, you can participate in the latest testnet as either a [Full Node](./join-testnet.md#run-a-full-node) or a [Validator](/validators/validator-setup.md).
 
 ## Install Go
 
diff --git a/docs/getting-started/networks.md b/docs/getting-started/networks.md
index abd2999baa..67f0dab5aa 100644
--- a/docs/getting-started/networks.md
+++ b/docs/getting-started/networks.md
@@ -9,7 +9,7 @@ From the [networks/local directory](https://github.com/cosmos/cosmos-sdk/tree/de
 
 ### Requirements
 
-- [Install gaia](https://cosmos.network/docs/getting-started/installation.html)
+- [Install gaia](./installation.md)
 - [Install docker](https://docs.docker.com/engine/installation/)
 - [Install docker-compose](https://docs.docker.com/compose/install/)
 
diff --git a/docs/introduction/tendermint.md b/docs/introduction/tendermint.md
index 62db8cdbc6..4192a03ea6 100644
--- a/docs/introduction/tendermint.md
+++ b/docs/introduction/tendermint.md
@@ -10,7 +10,7 @@ The ability to tolerate machines failing in arbitrary ways, including becoming m
 
 ## Application Blockchain Interface
 
-Tendermint consists of two chief technical components: a blockchain consensus engine and a generic application interface. The consensus engine, called Tendermint Core, ensures that the same transactions are recorded on every machine in the same order. The application interface, called the Application Blockchain Interface (ABCI), enables the transactions to be processed in any programming language. Unlike other blockchain and consensus solutions developers can use Tendermint for BFT state machine replication in any programming language or development environment. Visit the [Tendermint docs](https://tendermint.readthedocs.io/projects/tools/en/master/introduction.html#abci-overview) for a deep dive into the ABCI.
+Tendermint consists of two chief technical components: a blockchain consensus engine and a generic application interface. The consensus engine, called Tendermint Core, ensures that the same transactions are recorded on every machine in the same order. The application interface, called the Application Blockchain Interface (ABCI), enables the transactions to be processed in any programming language. Unlike other blockchain and consensus solutions developers can use Tendermint for BFT state machine replication in any programming language or development environment. Visit the [Tendermint docs](https://tendermint.com/docs/introduction/introduction.html#abci-overview) for a deep dive into the ABCI.
 
 ## Understanding the roles of the different layers
 
diff --git a/docs/sdk/clients.md b/docs/sdk/clients.md
index 5e5a9c7ac3..9637b3b4be 100644
--- a/docs/sdk/clients.md
+++ b/docs/sdk/clients.md
@@ -169,7 +169,7 @@ gaiacli tx broadcast --node=<node> signedSendTx.json
 
 #### Set up a Validator
 
-Please refer to the [Validator Setup](https://cosmos.network/docs/validators/validator-setup.html) section for a more complete guide on how to set up a validator-candidate.
+Please refer to the [Validator Setup](../validators/validator-setup.md) section for a more complete guide on how to set up a validator-candidate.
 
 #### Delegate to a Validator