Address PR comments

docs/DOCS_README.md

@@ -1,11 +1,6 @@
 ## Updating the docs
 
-If you open a PR on the Cosmos SDK, it is mandatory to update the relevant documentation in `/docs`. 
-
-- If your change relates to the core SDK (`baseapp`, `store`, ...), please update the `docs/gaia` folder, the `docs/examples` folder and possibly the `docs/spec` folder.
-- If your changes relate specifically to the `gaia` application (not including modules), please modify the `docs/gaia` folder. 
-- If your changes relate to a module, please update the module's spec in `docs/spec`. If the module is used by `gaia` and/or `basecoin`, you might also need to modify `docs/gaia` and/or `docs/examples`.
-- If your changes relate to the core of the CLI or Light-client (not specifically to module's CLI/Rest), please modify the `docs/clients` folder.
+If you want to open a PR on the Cosmos SDK to update the documentation, please follow the guidelines in the [`CONTRIBUTING.md`](https://github.com/cosmos/cosmos-sdk/tree/master/CONTRIBUTING.md)
 
 ## Docs Build Workflow
 

docs/README.md

@@ -9,24 +9,24 @@ Welcome to the SDK docs!
 
 ### SDK Intro
 
-If you are a newcomer and would like to learn more about the Cosmos SDK, this **[intro](./sdk.md)** is a good starting place.
+If you are a newcomer and would like to learn more about the Cosmos SDK, this **[intro](./intro/README.md)** is a good starting place.
 
 ### SDK tutorial
 
-If you like to learn by doing, you can follow the **[SDK application tutorial](https://github.com/cosmos/sdk-application-tutorial)**. It showcases how to build an SDK-based blockchain from scratch, and teaches you about the basic principles the SDK in the process. 
+If you like to learn by doing, you can follow the **[SDK application tutorial](https://github.com/cosmos/sdk-application-tutorial)**. It showcases how to build an SDK-based blockchain from scratch, and teaches you about the basic principles the SDK in the process.
 
 ## Use the SDK
 
-The following sections contain the information you need if you want to build a fully-fonctional SDK-based blockchain:
+The following sections contain the information you need if you want to build a fully-functional SDK-based blockchain:
 
->*NOTE*: We are currently working on improving the docs. Some info might be missing. 
+>*NOTE*: We are currently working on improving the docs. Some info might be missing. If that is the case, try the Cosmos [Forum](https://forum.cosmos.network). Failing that, [open an issue](https://github.com/cosmos/cosmos-sdk/issues/new).
 
 - [Introduction](./intro/README.md): Contains introductory high-level material on the Cosmos SDK.
-- [Gaia](./gaia/README.md): Contains all documentation related to the gaia application (current name for the Cosmos-Hub). 
+- [Gaia](./gaia/README.md): Contains all documentation related to the gaia application (current name for the Cosmos-Hub).
 - [Clients](./clients/README.md): Documentation about SDK clients like the SDK Command-Line interface and the SDK Light-client.
 - [Specifications](./spec/README.md): Contains SDK and modules specifications.
 
-If you are reading this on the Cosmos Website, please know that you can find more information on [github](https://github.com/cosmos/cosmos-sdk/tree/develop/docs).
+If you are reading this on the Cosmos Website, please know that you can find more information on [github](https://github.com/cosmos/cosmos-sdk/tree/develop/docs). Also if you find any issues with the documentation please [*open a Pull Request*](https://github.com/cosmos/cosmos-sdk/compare?expand=1), or at least [*open an Issue*](https://github.com/cosmos/cosmos-sdk/issues/new) to update the docs!
 
 ## Join the public testnet for the Cosmos Hub
 
@@ -36,5 +36,3 @@ To install the latest version of the `gaia` application and join the public test
 
 See [this file](./DOCS_README.md) for details of the build process and
 considerations when making changes.
-
-

docs/gaia/installation.md

@@ -1,4 +1,4 @@
-# Install `gaia`
+# Install Gaia
 
 This guide will explain how to install the `gaiad` and `gaiacli` entrypoints onto your system. With these 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).
 
@@ -20,7 +20,7 @@ echo "export PATH=$PATH:$GOBIN" >> ~/.bash_profile
 ## Install Cosmos SDK
 
 Next, let's install the latest version of Gaia. Here we'll use the `master` branch, which contains the latest stable release.
-If necessary, make sure you `git checkout` the correct 
+If necessary, make sure you `git checkout` the correct
 [released version](https://github.com/cosmos/cosmos-sdk/releases).
 
 ```bash
@@ -31,7 +31,7 @@ cd cosmos-sdk && git checkout master
 make get_tools && make get_vendor_deps && make install
 ```
 
-> *NOTE*: If you have issues at this step, please check that you have the latest stable version of GO installed. 
+> *NOTE*: If you have issues at this step, please check that you have the latest stable version of GO installed.
 
 That will install the `gaiad` and `gaiacli` binaries. Verify that everything is OK:
 

docs/gaia/join-testnet.md

@@ -1,23 +1,23 @@
 # Join the Testnet
 
 ::: tip Current Testnet
-See the [testnet repo](https://github.com/cosmos/testnets) for 
+See the [testnet repo](https://github.com/cosmos/testnets) for
 information on the latest testnet, including the correct version
 of the Cosmos-SDK to use and details about the genesis file.
 :::
 
-**Please ensure you have the [gaia binaries](/getting-started/installation.md) installed.**
+**Please ensure you have the [gaia binaries](/gaia/installation.md) installed.**
 
 If you ran a full node on a previous testnet, please skip to [Upgrading From Previous Testnet](#upgrading-from-previous-testnet).
 
 ## Setting Up a New Node
 
-These instructions are for setting up a brand new full node from scratch. 
+These instructions are for setting up a brand new full node from scratch.
 
 First, initialize the node and create the necessary config files:
 
 ```bash
-gaiad init 
+gaiad init
 ```
 
 ::: warning Note
@@ -77,12 +77,12 @@ git fetch --all && git checkout master
 make update_tools && make get_vendor_deps && make install
 ```
 
-> *NOTE*: If you have issues at this step, please check that you have the latest stable version of GO installed. 
+> *NOTE*: If you have issues at this step, please check that you have the latest stable version of GO installed.
 
 Note we use `master` here since it contains the latest stable release.
-See the [testnet repo](https://github.com/cosmos/testnets) 
-for details on which version is needed for which testnet, 
-and the [SDK release page](https://github.com/cosmos/cosmos-sdk/releases) 
+See the [testnet repo](https://github.com/cosmos/testnets)
+for details on which version is needed for which testnet,
+and the [SDK release page](https://github.com/cosmos/cosmos-sdk/releases)
 for details on each release.
 
 Your full node has been cleanly upgraded!
@@ -98,19 +98,14 @@ mkdir -p $HOME/.gaiad/config
 curl https://raw.githubusercontent.com/cosmos/testnets/master/latest/genesis.json > $HOME/.gaiad/config/genesis.json
 ```
 
-Note we use the `latest` directory in the [testnets repo](https://github.com/cosmos/testnets) 
+Note we use the `latest` directory in the [testnets repo](https://github.com/cosmos/testnets)
 which contains details for the latest testnet. If you are connecting to a different testnet, ensure you get the right files.
 
 ### Add Seed Nodes
 
-Your node needs to know how to find peers. You'll need to add healthy seed nodes to `$HOME/.gaiad/config/config.toml`. Here are some seed nodes you can use:
+Your node needs to know how to find peers. You'll need to add healthy seed nodes to `$HOME/.gaiad/config/config.toml`. The `testnets` repo contains links to the seed nodes for each testnet. If you are looking to join the running testnet please [check the repository for details](https://github.com/cosmos/testnets) on which nodes to use.
 
-```toml
-# Comma separated list of seed nodes to connect to
-seeds = "718145d422a823fd2a4e1e36e91b92bb0c4ddf8e@gaia-testnet.coinculture.net:26656,5922bf29b48a18c2300b85cc53f424fce23927ab@67.207.73.206:26656,7c8b8fd03577cd4817f5be1f03d506f879df98d8@gaia-7000-seed1.interblock.io:26656,a28737ff02391a6e00a1d3b79befd57e68e8264c@gaia-7000-seed2.interblock.io:26656,987ffd26640cd03d08ed7e53b24dfaa7956e612d@gaia-7000-seed3.interblock.io:26656"
-```
-
-If those seeds aren't working, you can find more seeds and persistent peers on the [Cosmos Explorer](https://explorecosmos.network/nodes). Open the the `Full Nodes` pane and select nodes that do not have private (`10.x.x.x`) or [local IP addresses](https://en.wikipedia.org/wiki/Private_network). The `Persistent Peer` field contains the connection string. For best results use 4-6.
+If those seeds aren't working, you can find more seeds and persistent peers on the [Cosmos Explorer](https://explorer.cosmos.network/nodes). Open the the `Full Nodes` pane and select nodes that do not have private (`10.x.x.x`) or [local IP addresses](https://en.wikipedia.org/wiki/Private_network). The `Persistent Peer` field contains the connection string. For best results use 4-6.
 
 You can also ask for peers on the [Validators Riot Room](https://riot.im/app/#/room/#cosmos-validators:matrix.org)
 

docs/gaia/validators/validator-setup.md

@@ -1,7 +1,7 @@
 # Validator Setup
 
 :::
-The current testnet is `gaia-9001`.
+Information on how to join the current testnet (`genesis.json` file and seeds) is held [in our `testnet` repo](https://github.com/cosmos/testnets/tree/master/latest). Please check there if you are looking to join our latest testnet. 
 :::
 
 Before setting up your validator node, make sure you've already gone through the [Full Node Setup](/docs/getting-started/full-node.md) guide.

docs/spec/README.md

@@ -1,8 +1,8 @@
 # Specifications
 
-This directory contains specifications for the modules of the Cosmos SDK as well as Interchain Standards (ICS) and other specifications.. 
+This directory contains specifications for the modules of the Cosmos SDK as well as Interchain Standards (ICS) and other specifications..
 
-SDK applications hold thri state in a Merkle store. Updates to
+SDK applications hold this state in a Merkle store. Updates to
 the store may be made during transactions and at the beginning and end of every
 block.
 
@@ -25,8 +25,7 @@ block.
 ### Interchain standards
 
 - [ICS30](./ics/ics-030-signed-messages.md) - Signed messages standard.
-- 
+-
 
 For details on the underlying blockchain and p2p protocols, see
 the [Tendermint specification](https://github.com/tendermint/tendermint/tree/develop/docs/spec).
-