add links for modules and clients

docs/README.md

@@ -51,16 +51,16 @@ NOTE: This documentation is a work-in-progress!
             interfaces for clients to use!
 
 - [Modules](modules)
-    - [Bank](modules/bank.md)
-    - [Staking](modules/staking.md)
-    - [Slashing](modules/slashing.md)
-    - [Provisions](modules/provisions.md)
-    - [Governance](modules/governance.md)
-    - [IBC](modules/ibc.md)
+    - [Bank](modules/README.md#bank)
+    - [Staking](modules/README.md#stake)
+    - [Slashing](modules/README.md#slashing)
+    - [Provisions](modules/README.md#provisions)
+    - [Governance](modules/README.md#governance)
+    - [IBC](modules/README.md#ibc)
 
 - [Clients](clients)
     - [Running a Node](clients/node.md) - Run a full node!
     - [Key Management](clients/keys.md) - Managing user keys
     - [CLI](clients/cli.md) - Queries and transactions via command line
-    - [Light Client Daemon](clients/lcd.md) - Queries and transactions via REST
+    - [REST](clients/rest.md) - Queries and transactions via REST
       API

docs/clients/cli.md

@@ -0,0 +1,6 @@
+# CLI
+
+See `gaiacli --help` for more details.
+
+Also see the [testnet
+tutorial](https://github.com/cosmos/cosmos-sdk/tree/develop/cmd/gaia/testnets).

docs/clients/keys.md

@@ -0,0 +1,6 @@
+# Keys
+
+See `gaiacli keys --help`.
+
+Also see the [testnet
+tutorial](https://github.com/cosmos/cosmos-sdk/tree/develop/cmd/gaia/testnets).

docs/clients/node.md

@@ -0,0 +1,10 @@
+# Running a Node
+
+TODO: document `gaiad`
+
+Options for running the `gaiad` binary are effectively the same as for `tendermint`. 
+See `gaiad --help` and the 
+[guide to using Tendermint](https://github.com/tendermint/tendermint/blob/master/docs/using-tendermint.md) 
+for more details.
+
+

docs/clients/rest.md

@@ -0,0 +1,6 @@
+# REST
+
+See `gaiacli advanced rest-server --help` for more.
+
+Also see the 
+[work in progress API specification](https://github.com/cosmos/cosmos-sdk/pull/1314)

docs/modules/README.md

@@ -0,0 +1,51 @@
+# Bank
+
+The `x/bank` module is for transferring coins between accounts.
+
+See the [API docs](https://godoc.org/github.com/cosmos/cosmos-sdk/x/bank).
+
+# Stake
+
+The `x/stake` module is for Cosmos Delegated-Proof-of-Stake.
+
+See the [API docs](https://godoc.org/github.com/cosmos/cosmos-sdk/x/stake).
+
+See the
+[specification](https://github.com/cosmos/cosmos-sdk/tree/develop/docs/spec/staking)
+
+# Slashing
+
+The `x/slashing` module is for Cosmos Delegated-Proof-of-Stake.
+
+See the [API docs](https://godoc.org/github.com/cosmos/cosmos-sdk/x/slashing)
+
+See the
+[specification](https://github.com/cosmos/cosmos-sdk/tree/develop/docs/spec/slashing)
+
+# Provisions
+
+The `x/provisions` module is for distributing fees and inflation across bonded
+stakeholders.
+
+See the [API docs](https://godoc.org/github.com/cosmos/cosmos-sdk/x/provisions)
+
+See the
+[specification](https://github.com/cosmos/cosmos-sdk/tree/develop/docs/spec/provisions)
+
+# Governance
+
+The `x/gov` module is for bonded stakeholders to make proposals and vote on them.
+
+See the [API docs](https://godoc.org/github.com/cosmos/cosmos-sdk/x/gov)
+
+See the
+[specification](https://github.com/cosmos/cosmos-sdk/tree/develop/docs/spec/governance)
+
+# IBC
+
+The `x/ibc` module is for InterBlockchain Communication.
+
+See the [API docs](https://godoc.org/github.com/cosmos/cosmos-sdk/x/ibc)
+
+See the
+[specification](https://github.com/cosmos/cosmos-sdk/tree/develop/docs/spec/ibc)